Skip to main content
GET
/
api
/
v1
/
voice
/
validate-info
Suno Voice Get Verification Phrase API
curl --request GET \
  --url https://api.example.com/api/v1/voice/validate-info \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "xxx_task_id_xxx",
    "validateInfo": "Harmonies fill the air with joyful melodies tonight",
    "status": "wait_processing, processing_validate: waiting for validation code, processing_validate_fail: failed to obtain validation code, wait_validating: waiting for verification, success, fail",
    "errorCode": 500,
    "errorMessage": "xxxxx"
  }
}

​
Usage Guide

  • Use the taskId returned by the validation phrase generation or regeneration API.
  • When the task reaches wait_validating, read validateInfo and ask the user to record that phrase.
  • If the task fails, inspect errorCode and errorMessage before retrying.

​
Status Handling

StatusMeaning
wait_processingTask is waiting to be processed
processing_validateValidation phrase is being generated
processing_validate_failValidation phrase generation failed
wait_validatingPhrase is ready and waiting for user verification
successThe full voice creation flow has completed
failTask failed

​
Next Step

Generate Voice

Submit the verification audio and create the final custom voice

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

Query Parameters

​
taskId
string

任务id

Response

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