Suno Voice 验证短句任务完成或失败时,通过 POST 回调接收结果。
当提交验证短句任务并传入 callBackUrl 后,系统会在任务进入最终状态时向您的回调地址发送 POST 请求。回调机制概述#
生产环境建议使用回调,减少对验证短句查询接口的轮询。
回调时机#
回调方式#
Content Type:application/json
回调请求格式#
{
"code": 200,
"msg": "success",
"data": {
"taskId": "xxx_task_id_xxx",
"validateInfo": "请清晰录制这段验证短句。",
"status": "wait_validating",
"errorCode": 0,
"errorMessage": ""
}
}
字段说明#
code · integer · required回调状态码。200 表示成功,非 200 表示任务失败或处理异常。data.taskId · string · requireddata.validateInfo · string验证短句文本。当 status 为 wait_validating 时返回。data.status · string · required任务状态。常见回调状态包括 wait_validating、processing_validate_fail 和 fail。data.errorMessage · string接收回调示例#
相关接口#
获取验证短句
使用 taskId 手动查询同一任务状态