Skip to main content
POST
/
api
/
v1
/
voice
/
validate
Suno Voice Generate Verification Phrase API
curl --request POST \
  --url https://api.example.com/api/v1/voice/validate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "voiceUrl": "https://example.com/audio/user_voice.mp3",
  "vocalStartS": 0,
  "vocalEndS": 10,
  "language": "en",
  "callBackUrl": "https://example.com/callback/suno/voice_prepare"
}
'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "xxx_task_id_xxx"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.api.box/llms.txt

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

​
Usage Guide

  • Submit the source recording URL and the vocal segment you want to use for voice creation.
  • The API returns a taskId; use it to query the generated validation phrase.
  • When callBackUrl is provided, the system sends a POST callback when the phrase is ready or the task fails. The callback URL must be publicly accessible and return HTTP 200 within 15 seconds.
  • After receiving validateInfo, ask the user to record the phrase and upload the verification audio to the voice generation API. For best voice generation results, singing is recommended.

​
Workflow

  1. Upload or host the source audio and make sure voiceUrl is publicly accessible.
  2. Choose a clean vocal segment with vocalStartS and vocalEndS.
  3. Submit the validation phrase task and store the returned taskId.
  4. Wait for validateInfo through the query API or callback.
  5. Record the user performing the validation phrase, then call the custom voice generation API. For best voice generation results, singing is recommended.

​
Callback

Validation Phrase Callbacks

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

​
Developer Notes

  • vocalEndS must be greater than vocalStartS.
  • Use a segment with clear speech and minimal background noise for better validation.
  • language controls the validation phrase language. Supported values include en, zh, es, fr, pt, de, ja, ko, hi, and ru.

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
​
voiceUrl
string
required

The original recording URL uploaded by the user [Required]

​
vocalStartS
integer
required

Start time (in seconds) for extracting the vocal segment [Required]

​
vocalEndS
integer
required

End time (in seconds) for extracting the vocal segment, must be greater than vocalStartS [Required]

​
language
string

Verify the language of the short phrase. Supported languages ​​include: English (en), Chinese (zh), Spanish (es), French (fr), Portuguese (pt), German (de), Japanese (ja), Korean (ko), Hindi (hi), and Russian (ru).

​
callBackUrl
string

Callback URL used to receive validation phrase generation results. The system sends a POST request when the 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 Validation Phrase Callbacks.

Response

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