音乐扩展回调
callBackUrl 参数设置回调地址。任务完成后，系统会自动将结果推送到您指定的地址。回调机制概述
回调时机
回调方式
回调请求格式
callBackUrl 发送 POST 请求，格式如下：完成成功回调
第一首完成回调
文本生成完成回调
失败回调
{
"code": 200,
"msg": "Playground task completed successfully.",
"data": {
"taskId": "454b92c8a2d8c8a3bd869f2c0804a1ec",
"model": "suno/extend",
"state": "success",
"param": "{\"model\":\"suno/extend\",\"callBackUrl\":\"<https://d06e-103-151-173-99.ngrok-free.app/client/v1/webhook/test\",\"input\":\">{\\\"defaultParamFlag\\\":true,\\\"audioId\\\":\\\"6e01a7d4-651f-4eb2-9133-b74f2de1c7d0\\\",\\\"prompt\\\":\\\"Extend the music with more relaxing notes and a gentle bridge section\\\",\\\"model\\\":\\\"V5\\\",\\\"style\\\":\\\"Classical\\\",\\\"title\\\":\\\"Peaceful Piano Extended\\\",\\\"continueAt\\\":60,\\\"negativeTags\\\":\\\"Heavy Metal, Upbeat Drums\\\",\\\"vocalGender\\\":\\\"m\\\",\\\"styleWeight\\\":0.65,\\\"weirdnessConstraint\\\":0.65,\\\"audioWeight\\\":0.65}\"}",
"costTime": 68,
"completeTime": 1785982090000,
"createTime": 1785982021000,
"updateTime": 1785982090000,
"creditsConsumed": 12,
"resultJson": "{\"sunoData\":[{\"duration\":69.96,\"stream_audio_url\":\"<https://cdn1.suno.ai/12f38010-c188-418b-aa22-de3b1279342e.mp3\",\"image_suno_watermark\":false,\"model_name\":\"chirp-crow\",\"image_url\":\"https://tempfile.aiquickdraw.com/r/d9b72ad692e54856b9ff06a5ab5873c3.jpeg\",\"audio_url\":\"https://tempfile.aiquickdraw.com/r/b7d01b0af7644dabbd5531a5a3e0379a.mp3\",\"id\":\"12f38010-c188-418b-aa22-de3b1279342e\",\"title\":\"Peaceful> Piano Extended\",\"prompt\":\"\\n\\nExtend the music with more relaxing notes and a gentle bridge section\",\"tags\":\"Classical\"},{\"duration\":87.0,\"stream_audio_url\":\"<https://cdn1.suno.ai/2fa5e769-9ea3-42b4-9a20-e92e5480e6fa.mp3\",\"image_suno_watermark\":false,\"model_name\":\"chirp-crow\",\"image_url\":\"https://tempfile.aiquickdraw.com/r/09062ec284404e90a41bf69dc2b1bbfd.jpeg\",\"audio_url\":\"https://tempfile.aiquickdraw.com/r/eab58f75e9f14ed198694c923985ba33.mp3\",\"id\":\"2fa5e769-9ea3-42b4-9a20-e92e5480e6fa\",\"title\":\"Peaceful> Piano Extended\",\"prompt\":\"\\n\\nExtend the music with more relaxing notes and a gentle bridge section\",\"tags\":\"Classical\"}]}"
}
}状态码说明
code (integer, required)
| 状态码 | 说明 |
|---|---|
| 200 | 成功 - 请求已成功处理 |
| 400 | 验证错误 - 歌词包含受版权保护的内容 |
| 408 | 超出限制 - 超时 |
| 413 | 冲突 - 上传的音频与现有艺术作品匹配 |
| 500 | 服务器错误 - 处理请求时发生意外错误 |
| 501 | 音频生成失败 |
| 531 | 服务器错误 - 抱歉，由于问题生成失败。您的积分已退还。请重试 |
msg (string, required)
data.callbackType (string, required)
data.task_id (string, required)
data.data (array, required)
data.data[].id (string)
data.data[].audio_url (string)
data.data[].stream_audio_url (string)
data.data[].image_url (string)
data.data[].prompt (string)
data.data[].model_name (string)
data.data[].title (string)
data.data[].tags (string)
data.data[].createTime (string)
data.data[].duration (number)
回调接收示例
Node.js
最佳实践
回调 URL 配置建议
1.
2.
3.
4.
5.
6.
7.