Skip to main content
POST
/
suno
/
submit
/
music
curl --request POST \
  --url https://api.deerapi.com/suno/submit/music \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'
{
  "code": "<string>",
  "message": "<string>",
  "data": "<string>"
}
/suno/submit/music 接口允许您生成具有特定细节的音乐片段。共有六种模式可用于不同的场景。 提交音乐生成请求后,您可以使用返回的 task_id 通过 单任务查询 接口查询生成结果并跟踪任务状态。
💡 完整请求示例: 我们已在下方的代码示例部分提供了所有六种模式的完整 JSON 请求示例,请参考这些示例以了解详细的参数用法和结构。

模式说明

  1. 灵感模式(Inspiration Mode):只需提供一个主题,歌词和音乐风格都将由 AI 决定。
  2. 自定义模式(Custom Mode):需要提供歌词、音乐风格和歌曲标题来创建您的自定义音乐作品。
  3. 歌曲续写模式(Song Continuation):与自定义模式参数几乎相同,但需要额外几个参数来定位您之前的音乐片段并根据您的指示继续生成:task_idcontinue_clip_idcontinue_attask
  4. 人设模式(Persona Mode):使用特定的艺术家人设创建具有一致风格的音乐。
  5. 配音模式(Dubbing Mode):为现有音频添加器乐伴奏。
  6. 填词模式(Lyrics Mode):为现有器乐音轨添加人声。

1. 灵感模式

  • gpt_description_prompt(字符串):音乐生成的提示词。基本上是一句话或几个词来描述您希望歌曲的主题。
  • mv(字符串):音乐模型的版本(例如:chirp-auk)。

2. 自定义模式

  • prompt(字符串):音乐提交的歌词。
  • tags(字符串):与提交相关的音乐风格标签。
  • mv(字符串):音乐模型的版本(例如:chirp-v4)。
  • title(字符串):音乐提交的标题。

3. 歌曲续写模式

  • prompt(字符串):音乐续写的歌词。
  • tags(字符串):与提交相关的音乐风格标签。
  • negative_tags(字符串):音乐生成中要避免的标签。
  • mv(字符串):音乐模型的版本。
  • title(字符串):音乐提交的标题。
  • task_id(字符串):原始任务的标识符。
  • continue_clip_id(字符串):要继续的片段标识符。
  • continue_at(数字):音乐中继续的位置(以秒为单位)。
  • task(字符串):必须设置为 "extend"

4. 使用人设创建音乐

使用先前创建的人设,以一致的艺术家风格创建音乐。
  • prompt(字符串):音乐提交的歌词。
  • generation_type(字符串):生成类型(例如:"TEXT")。
  • tags(字符串):音乐风格标签。
  • negative_tags(字符串):要避免的标签。
  • mv(字符串):音乐模型的版本。
  • title(字符串):音乐提交的标题。
  • task_id(字符串):任务的标识符。
  • task(字符串):任务类型标识符。
  • persona_id(字符串):从创建人设接口获得的人设标识符。
  • artist_clip_id(字符串):来自先前音乐生成步骤的片段 ID。
⚠️ 人设模式重要注意事项:
  • mv 必须是以下之一:chirp-v3-5-tauchirp-v4-tauchirp-auk
  • task 必须设置为 "artist_consistency"
  • persona_id 是从创建新人设接口获得的 ID
  • artist_clip_id 是从生成音乐步骤中获得的 clip_id

5. 配音模式(伴奏)

为现有音频内容添加器乐伴奏。
  • mv(字符串):音乐模型的版本(例如:chirp-bluejay)。
  • tags(字符串):对所需器乐风格的详细描述。
  • title(字符串):输出的标题。
  • underpainting_clip_id(字符串):要添加伴奏的片段 ID。
  • underpainting_start_s(数字):开始时间(以秒为单位)。
  • underpainting_end_s(数字):结束时间(以秒为单位)。
  • task(字符串):必须设置为 "underpainting"
  • prompt(字符串):纯器乐生成时可以为空。
  • override_fields(数组):要覆盖的字段(例如:["prompt", "tags"])。

6. 填词模式(人声)

为现有器乐音轨添加人声层。
  • mv(字符串):音乐模型的版本(例如:chirp-bluejay)。
  • tags(字符串):对所需人声风格和音乐特征的详细描述。
  • title(字符串):输出的标题。
  • overpainting_clip_id(字符串):要添加人声的片段 ID。
  • overpainting_start_s(数字):开始时间(以秒为单位)。
  • overpainting_end_s(数字):结束时间(以秒为单位)。
  • task(字符串):必须设置为 "overpainting"
  • prompt(字符串):要演唱的歌词。
  • override_fields(数组):要覆盖的字段(例如:["prompt", "tags"])。

Authorizations

Authorization
string
header
required

Bearer token authentication. Use your DeerAPI key.

Body

application/json
prompt
string
default:Hello
required

歌词 (自定义模式专用)

make_instrumental
boolean
default:true
required

是否生成纯音乐,true 为生成纯音乐

negative_tags
string
default:example
required

排除的风格标签

tags
string

风格标签(自定义模式专用)

mv
enum<string>

版本号

Available options:
chirp-v3.0,
chirp-v3.5,
chirp-v4,
chirp-auk,
chirp-bluejay,
chirp-crow
title
string

标题(自定义模式专用)

notify_hook
string

回调地址: https://xxxxxxx

gpt_description_prompt
string

灵感模式提示词(灵感模式专用)

task
string

上传后续写必填

continue_clip_id
string

歌曲id,需要续写哪首歌

continue_at
string

float,歌曲延长时间,单位秒

task_id
string

任务id,用于对之前的任务再操作

Response

200 - application/json

Successful Response

code
string
required

业务状态码

message
string
required

提示信息

data
string
required

返回数据