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"
  }
}

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

  • 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