Skip to main content
POST
/
api
/
v1
/
voice
/
regenerate
Suno Voice Regenerate Verification Phrase
curl --request POST \
  --url https://api.example.com/api/v1/voice/regenerate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "taskId": "xxxxxxx",
  "calBackUrl": "https://example.com/callback/suno/voice_regenerate"
}
'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "xxx_task_id_xxx"
  }
}

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.

​
Usage Guide

  • Use this API when the previous validation phrase failed, expired, or the user needs a new phrase.
  • Submit the existing taskId from the voice validation workflow.
  • The API schema uses calBackUrl for the callback URL field. The system sends a POST callback when the regenerated phrase is ready or the task fails. The callback URL must be publicly accessible and return HTTP 200 within 15 seconds.
  • Query the validation phrase result again with the returned taskId.

​
Workflow

  1. Submit the existing validation task ID.
  2. Store the returned taskId.
  3. Wait for the regenerated validateInfo through the query API or callback.
  4. Ask the user to record the new phrase and submit the verification audio to the voice generation API. For best voice generation results, singing is recommended.

​
Callback

Regenerated Validation Phrase Callbacks

Learn the callback payload sent when the regenerated phrase is ready or the task fails

​
Developer Notes

  • Keep the regenerated phrase and verification recording paired with the same task flow.
  • If phrase generation repeatedly fails, choose a cleaner source vocal segment and restart the validation step.

Authorizations

​
Authorization
string
header
required

API Authentication

All endpoints require authentication using Bearer Token.

Get API Key

  1. Visit the API Key Management Page to obtain your API Key

Usage

Add to request headers:

Authorization: Bearer YOUR_API_KEY

Note:

  • Keep your API Key secure and do not share it with others
  • If you suspect your API Key has been compromised, reset it immediately from the management page

Body

application/json
​
taskId
string
required

Task ID

​
calBackUrl
string
required

Callback URL used to receive regenerated validation phrase results. Note that this endpoint uses the field name calBackUrl. The system sends a POST request when the new phrase is ready (status: wait_validating) or when the task fails. The URL must be publicly accessible and return HTTP 200 within 15 seconds. For the payload format, see Regenerated Validation Phrase Callbacks.

Response

200 - application/json
​
code
integer
required
​
msg
string
required
​
data
object
required