Suno Voice Generate Verification Phrase API

POST

/api/v1/voice/validate

Generate a validation phrase for the Suno Voice custom voice workflow.Submit the source audio URL and the selected vocal segment. The system will analyze the source voice and create a validation phrase that the user needs to read in the next step.

Query Task Status #

After submitting the task, you can check the validation phrase generation progress and obtain the generated phrase through the validation phrase query endpoint:

Get Validation Phrase

Learn how to check the validation phrase task status and obtain the phrase users need to read

In the production environment, it is recommended to use the callBackUrl parameter to receive automatic notifications when the validation phrase is ready, rather than polling the status endpoint.

Next Step #

After the validation phrase is ready, ask the user to read the phrase and upload the recorded verification audio to continue creating the voice.

Generate Voice

Submit the verification audio and generate the final custom voice

Related resources

Regenerate Validation Phrase

Generate a new validation phrase for an existing task

General API

View account credits and usage

Request

Authorization

Bearer Token

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

Example:

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

or

Body Params application/jsonRequired

Generate Code

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

optional

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

optional

Callback URL after the task is completed

Examples

Responses

🟢200

application/json

Generate Code

Bodyapplication/json

Generate Code

code

integer

required

msg

string

required

data

object

required

taskId

string

required

Task ID

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

Response Response Example

{
    "code": 200,
    "msg": "success",
    "data": {
        "taskId": "xxx_task_id_xxx"
    }
}