Suno Voice Get Verification Phrase API

GET

/api/v1/voice/validate-info

Query the validation phrase generation result for a Suno Voice task.Use this endpoint with the taskId returned by the validation phrase generation or regeneration endpoint. When the task is ready, the response contains validateInfo, which is the phrase the user needs to read for voice verification.

Status Handling #

Check the status field to determine the next action:

wait_processing or processing_validate: the validation phrase is still being generated

processing_validate_fail or fail: the task failed, check errorMessage for details

wait_validating: the phrase is ready and waiting for the user to read it

success: the validation and voice creation flow has completed

Continue the Flow #

After receiving validateInfo, record or upload the user's verification audio and submit it to the voice generation endpoint:

Generate Voice

Submit the user's verification audio to generate the final custom voice

Related resources

Generate Validation Phrase

Create a validation phrase from source audio

Regenerate Validation Phrase

Generate a new phrase for an existing task

Request

Authorization

Bearer Token

Provide your bearer token in the Authorization header when making requests to protected resources.

Example:

Authorization: Bearer ********************

or

Query Params

Generate Code

taskId

string

optional

任务id

Responses

🟢200

application/json

Generate Code

Bodyapplication/json

Generate Code

code

integer

required

msg

string

required

data

object

required

taskId

string

required

Task ID

validateInfo

string

required

Validation phrase text

status

enum<string>

required

Task status

Allowed values:

wait_processingWaiting for Processing

Task is waiting to be processedprocessing_validateProcessing Validation

Waiting for validation codeprocessing_validate_failValidation Processing Failed

Failed to obtain validation codewait_validatingWaiting for Verification

Waiting for user verificationsuccessSuccess

Task completed successfullyfailFailed

Task failed

errorCode

integer

required

errorMessage

string

required

Request Request Example

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

cURLcURL-WindowsHttpiewgetPowerShell

curl --location 'https://api.kie.ai/api/v1/voice/validate-info?taskId=undefined' \
--header 'Authorization: Bearer <token>'

Response Response Example

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