音频上传和扩展回调
callBackUrl 参数设置回调地址。任务完成后，系统会自动将结果推送到您指定的地址。回调机制概述
回调时机
回调方式
回调请求格式
callBackUrl 发送 POST 请求，格式如下：完成成功回调
第一首完成回调
文本生成完成回调
失败回调
{
"msg": "Playground task completed successfully.",
"code": 200,
"data": {
"resultJson": "{\"sunoData\":[{\"duration\":209.0,\"stream_audio_url\":\"https://cdn1.suno.ai/dc972ed1-45df-46d7-b00b-dc656ea27c56.mp3\",\"image_suno_watermark\":false,\"model_name\":\"chirp-crow\",\"image_url\":\"https://tempfile.aiquickdraw.com/r/fb3d77123bbc47fcbd90405ac1a866eb.jpeg\",\"audio_url\":\"https://tempfile.aiquickdraw.com/r/b0ea6b002f604c7f9fcedf0da65eeab1.mp3\",\"id\":\"dc972ed1-45df-46d7-b00b-dc656ea27c56\",\"title\":\"Summer Vibes Cover\",\"prompt\":\"[Intro]\\n[dizi flute melody, arpeggiated grand piano, sustained string pads]\\n\\n[Verse 1]\\n[female vocals enter, piano continues arpeggios]\\n晨霧青山，淡煙一指，夢龍詩行\\n鳥語斜芳，裁開一縷，曉日曙光\\n暮色鋪廣，霞披萬丈，琉璃艷妝\\n宇宙長挽，揉碎一湖，清清波光\\n[strings swell]\\n小荷姑娘，眉宇間寫滿，青春飛揚\\n\\n\",\"tags\":\"Pop, Electronic, Uplifting\"},{\"duration\":197.76,\"stream_audio_url\":\"https://cdn1.suno.ai/f9d8df29-1741-4b0f-b470-43bbed63f056.mp3\",\"image_suno_watermark\":false,\"model_name\":\"chirp-crow\",\"image_url\":\"https://tempfile.aiquickdraw.com/r/c778d6471d4149919929a080d153b9d6.jpeg\",\"audio_url\":\"https://tempfile.aiquickdraw.com/r/cb153604fa5b4984833f215f2b89b3ef.mp3\",\"id\":\"f9d8df29-1741-4b0f-b470-43bbed63f056\",\"title\":\"Summer Vibes Cover\",\"prompt\":\"[Intro]\\n[dizi flute melody, arpeggiated grand piano, sustained string pads]\\n\\n[Verse 1]\\n[female vocals enter, piano continues arpeggios]\\n晨霧青山，淡煙一指，夢龍詩行\\n鳥語斜芳，裁開一縷，曉日曙光\\n暮色鋪廣，霞披萬丈，琉璃艷妝\\n宇宙長挽，揉碎一湖，清清波光\\n[strings swell]\\n小荷姑娘，眉宇間寫滿，青春飛揚\\n\\n\",\"tags\":\"Pop, Electronic, Uplifting\"}]}",
"param": "{\"model\":\"suno/upload-and-extend-audio\",\"input\":\"{\\\"model\\\":\\\"V5\\\",\\\"uploadUrl\\\":\\\"https://tempfileb.aiquickdraw.com/kieai/market/1786352987861_pXQkcyQq.mp3\\\",\\\"defaultParamFlag\\\":true,\\\"instrumental\\\":true,\\\"prompt\\\":\\\"Create an uplifting pop cover version of the uploaded audio with modern production, driving beat, and soaring vocal harmonies. Add electronic elements and build energy throughout the track,Callback by text, first song, and final callback order\\\",\\\"style\\\":\\\"Pop, Electronic, Uplifting\\\",\\\"title\\\":\\\"Summer Vibes Cover\\\",\\\"continueAt\\\":25,\\\"styleWeight\\\":0.45,\\\"weirdnessConstraint\\\":0.39,\\\"audioWeight\\\":0.26}\",\"callBackUrl\":\"http://localhost:8305/test\"}",
"costTime": 210,
"createTime": 1786356905000,
"completeTime": 1786357127000,
"model": "suno/upload-and-extend-audio",
"updateTime": 1786357127000,
"state": "success",
"creditsConsumed": 12,
"taskId": "857d1ad2a4c9b7eeef065676e1d945c7"
}
}状态码说明
回调参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
code | integer | 是 | 回调状态码，表示任务处理结果： - 200: 成功 - 请求已成功处理 - 400: 验证错误 - 歌词包含受版权保护的内容 - 408: 超出限制 - 超时 - 413: 冲突 - 上传的音频与现有艺术作品匹配 - 500: 服务器错误 - 处理请求时发生意外错误 - 501: 音频生成失败 - 531: 服务器错误 - 抱歉， 由于问题生成失败。您的积分已退还。请重试 |
msg | string | 是 | 状态消息，提供详细的状态描述 |
data.callbackType | string | 是 | 回调类型，表示生成阶段： - text: 文本生成完成 - first: 第一首完成 - complete: 全部完成 - error: 生成失败 |
data.task_id | string | 是 | 任务 ID，与您提交任务时返回的 taskId 一致 |
data.data | array | 是 | 生成的音频数组。文本回调或失败时为空。 |
音频对象参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
data.data[].id | string | 否 | 音频唯一标识 |
data.data[].audio_url | string | 否 | 生成的音频文件 URL，用于下载 |
data.data[].source_audio_url | string | 否 | 原始音频文件 URL |
data.data[].stream_audio_url | string | 否 | 生成的流式音频 URL，用于实时播放 |
data.data[].source_stream_audio_url | string | 否 | 原始流式音频 URL |
data.data[].image_url | string | 否 | 生成的封面图片 URL |
data.data[].source_image_url | string | 否 | 原始封面图片 URL |
data.data[].prompt | string | 否 | 使用的生成提示词/歌词 |
data.data[].model_name | string | 否 | 使用的模型名称（如 "chirp-v3-5"） |
data.data[].title | string | 否 | 音乐标题 |
data.data[].tags | string | 否 | 音乐标签/风格 |
data.data[].createTime | string | 否 | 创建时间戳 |
data.data[].duration | number | 否 | 音频时长（秒） |
回调接收示例
Node.js
Python
PHP
最佳实践
回调 URL 配置建议
1.
2.
3.
4.
5.
6.
7.
重要提醒