Receive POST callbacks when a Suno Voice validation phrase task is ready or fails.
When you submit a validation phrase task with callBackUrl, the system sends a POST request to your callback URL after the validation phrase task reaches a terminal state.Callback Mechanism Overview#
Use callbacks in production to avoid polling the validation phrase query endpoint.
Callback Timing#
Validation phrase generated and ready for the user to record
Validation phrase generation failed
Error occurred during task processing
Callback Method#
Content Type: application/json
Validation Phrase Ready Callback
Validation Phrase Failed Callback
{
"code": 200,
"msg": "success",
"data": {
"taskId": "xxx_task_id_xxx",
"validateInfo": "Please record this validation phrase clearly.",
"status": "wait_validating",
"errorCode": 0,
"errorMessage": ""
}
}
Field Description#
code · integer · requiredCallback status code. 200 indicates success; non-200 values indicate task failure or processing error.Status message describing the callback result.data.taskId · string · requiredTask ID returned by the validation phrase generation API.data.validateInfo · stringValidation phrase text. Returned when status is wait_validating.data.status · string · requiredTask status. Common callback statuses are wait_validating, processing_validate_fail, and fail.Error code returned when the task fails.data.errorMessage · stringDetailed error message returned when the task fails.Receiving Callbacks#
Get Verification Phrase
Query the same task status manually with taskId