DeerAPI 生成音乐接口文档:POST /suno/submit/music 支持 Suno 六种模式(灵感、自定义、续写、人设、配音、填词)提交生成请求,并通过 task_id 查询任务状态与结果。
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 请求示例,请参考这些示例以了解详细的参数用法和结构。
task_id、continue_clip_id、continue_at、task。
gpt_description_prompt(字符串):音乐生成的提示词。基本上是一句话或几个词来描述您希望歌曲的主题。mv(字符串):音乐模型的版本(例如:chirp-auk)。prompt(字符串):音乐提交的歌词。tags(字符串):与提交相关的音乐风格标签。mv(字符串):音乐模型的版本(例如:chirp-v4)。title(字符串):音乐提交的标题。prompt(字符串):音乐续写的歌词。tags(字符串):与提交相关的音乐风格标签。negative_tags(字符串):音乐生成中要避免的标签。mv(字符串):音乐模型的版本。title(字符串):音乐提交的标题。task_id(字符串):原始任务的标识符。continue_clip_id(字符串):要继续的片段标识符。continue_at(数字):音乐中继续的位置(以秒为单位)。task(字符串):必须设置为 "extend"。prompt(字符串):音乐提交的歌词。generation_type(字符串):生成类型(例如:"TEXT")。tags(字符串):音乐风格标签。negative_tags(字符串):要避免的标签。mv(字符串):音乐模型的版本。title(字符串):音乐提交的标题。task_id(字符串):任务的标识符。task(字符串):任务类型标识符。persona_id(字符串):从创建人设接口获得的人设标识符。artist_clip_id(字符串):来自先前音乐生成步骤的片段 ID。⚠️ 人设模式重要注意事项:
mv必须是以下之一:chirp-v3-5-tau、chirp-v4-tau或chirp-auktask必须设置为"artist_consistency"persona_id是从创建新人设接口获得的 IDartist_clip_id是从生成音乐步骤中获得的clip_id
mv(字符串):音乐模型的版本(例如:chirp-bluejay)。tags(字符串):对所需器乐风格的详细描述。title(字符串):输出的标题。underpainting_clip_id(字符串):要添加伴奏的片段 ID。underpainting_start_s(数字):开始时间(以秒为单位)。underpainting_end_s(数字):结束时间(以秒为单位)。task(字符串):必须设置为 "underpainting"。prompt(字符串):纯器乐生成时可以为空。override_fields(数组):要覆盖的字段(例如:["prompt", "tags"])。mv(字符串):音乐模型的版本(例如:chirp-bluejay)。tags(字符串):对所需人声风格和音乐特征的详细描述。title(字符串):输出的标题。overpainting_clip_id(字符串):要添加人声的片段 ID。overpainting_start_s(数字):开始时间(以秒为单位)。overpainting_end_s(数字):结束时间(以秒为单位)。task(字符串):必须设置为 "overpainting"。prompt(字符串):要演唱的歌词。override_fields(数组):要覆盖的字段(例如:["prompt", "tags"])。Bearer token authentication. Use your DeerAPI key.
歌词 (自定义模式专用)
是否生成纯音乐,true 为生成纯音乐
排除的风格标签
风格标签(自定义模式专用)
版本号
chirp-v3.0, chirp-v3.5, chirp-v4, chirp-auk, chirp-bluejay, chirp-crow 标题(自定义模式专用)
回调地址: https://xxxxxxx
灵感模式提示词(灵感模式专用)
上传后续写必填
歌曲id,需要续写哪首歌
float,歌曲延长时间,单位秒
任务id,用于对之前的任务再操作
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>"
}