当MP4生成完成后，系统会向提供的回调URL发送POST请求通知结果当您向Suno API提交音乐视频生成任务时，可以使用 callBackUrl 参数设置回调URL。任务完成时，系统将自动向您指定的地址推送结果。回调机制概述#
回调机制消除了轮询API获取任务状态的需要。系统会主动向您的服务器推送任务完成结果。
Webhook 安全性：为确保回调请求的真实性和完整性，我们强烈建议您实现 webhook 签名验证。请参阅我们的 Webhook 校验指南 了解详细实现步骤。 回调时机#
回调方式#
Content Type: application/json
回调请求格式#
任务完成时，系统将以下格式向您的 callBackUrl 发送POST请求：{
"code": 200,
"msg": "All generated successfully.",
"data": {
"task_id": "task_id_5bbe7721119d",
"video_url": "video_url_847715e66259"
}
}
状态码说明#
code (integer, required)#
| 状态码 | 描述 |
|---|
| 200 | 成功 - 请求已成功处理 |
| 500 | 内部错误 - 请稍后再试 |
msg (string, required)#
data.task_id (string, required)#
生成任务的唯一标识符，与您提交任务时返回的task_id一致data.video_url (string)#
回调接收示例#
最佳实践#
回调URL配置建议#
1.
使用HTTPS: 确保回调URL使用HTTPS协议以保证数据传输安全
3.
幂等处理: 同一task_id可能收到多次回调，确保处理逻辑是幂等的
4.
快速响应: 回调处理应尽快返回200状态码以避免超时
5.
异步处理: 复杂的业务逻辑应异步处理以避免阻塞回调响应
6.
及时下载: 视频链接有效期仅14天，建议及时下载保存
重要提醒#
请确保回调处理逻辑的稳定性，避免因异常导致回调失败
视频URL有效期为14天，请及时下载保存到本地存储
故障排查#
网络连接问题
服务器响应问题
内容格式问题
检查Content-Type是否为application/json
视频处理问题
替代方案#
轮询查询结果
使用获取音乐视频详情端点定期查询任务状态。我们建议每30秒查询一次， 