Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.sunoapi.org/llms.txt

Use this file to discover all available pages before exploring further.

When you submit a phrase regeneration task, provide the callback URL using the calBackUrl field from the API schema. The system sends a POST request when the regenerated phrase is ready or the task fails.

​
Callback Mechanism Overview

The regenerated phrase callback uses the same response shape as validation phrase generation callbacks.

​
Callback Timing

  • New validation phrase generated and ready for the user to record
  • Phrase regeneration failed
  • Error occurred during task processing

​
Callback Method

  • HTTP Method: POST
  • Content Type: application/json
  • Timeout: 15 seconds

​
Callback Request Format

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "xxx_task_id_xxx",
    "validateInfo": "Please record this new validation phrase clearly.",
    "status": "wait_validating",
    "errorCode": 0,
    "errorMessage": ""
  }
}

​
Field Description

​
code
integer
required
Callback status code. 200 indicates success; non-200 values indicate task failure or processing error.
​
msg
string
required
Status message describing the callback result.
​
data.taskId
string
required
Task ID returned by the phrase regeneration API.
​
data.validateInfo
string
Regenerated validation phrase text. Returned when status is wait_validating.
​
data.status
string
required
Task status. Common callback statuses are wait_validating, processing_validate_fail, and fail.
​
data.errorCode
integer
Error code returned when the task fails.
​
data.errorMessage
string
Detailed error message returned when the task fails.

Get Verification Phrase

Query the regenerated phrase manually with taskId