Suno Voice 生成回调
/api/v1/voice/validate接口中使用callBackUrl参数设置回调地址。任务完成后，系统会自动将验证短句结果推送到您指定的地址。回调机制概述
Webhook安全说明
回调时机
回调方式
回调请求格式
callBackUrl发送POST请求：成功回调
失败回调
{
"code": 200,
"msg": "success",
"data": {
"taskId": "xxx_task_id_xxx",
"validateInfo": "Harmonies fill the air with joyful melodies tonight",
"status": "wait_validating",
"errorCode": null,
"errorMessage": ""
}
}状态码说明
code（整数，必填）
| 状态码 | 说明 |
|---|---|
| 200 | 成功 - 验证短句已成功生成 |
| 500 | 失败 - 验证短句生成失败或内部处理出错 |
msg（字符串，必填）
data.taskId（字符串，必填）
data.validateInfo（字符串）
data.status（字符串）
| 状态 | 说明 |
|---|---|
| wait_processing | 等待处理验证短句 |
| processing_validate | 正在生成验证短句 |
| processing_validate_fail | 验证短句生成失败 |
| wait_validating | 验证短句已就绪，等待用户验证 |
| success | 任务成功完成 |
| fail | 任务失败 |
data.errorCode（整数）
null。data.errorMessage（字符串）
回调接收示例
Node.js
Python
PHP
最佳实践
回调地址配置建议
1.
2.
3.
4.
5.
6.
重要提醒