v1

latestOpenAPI 3.0.02026-07-26355125.0 KB

docs/en/Market/Suno API/voice

suno接口/voice

Suno Voice Generate Verification Phrase API

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 for the user to record 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:

<Card title="Get Validation Phrase" icon="lucide-search" href="/suno-api/suno-voice-validate-info"

Learn how to check the validation phrase task status and obtain the phrase users should record </Card>

:::tip[] 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 record the phrase and upload the verification audio to continue creating the voice. For best voice generation results, singing is recommended.

<Card title="Generate Voice" icon="lucide-mic" href="/suno-api/suno-voice-generate"

Submit the verification audio and generate the final custom voice </Card>

Related resources

<CardGroup cols={2}> <Card title="Regenerate Validation Phrase" icon="lucide-refresh-cw" href="/suno-api/suno-voice-regenerate"> Generate a new validation phrase for an existing task </Card> <Card title="General API" icon="lucide-cog" href="/suno-api/get-remaining-credits"> View account credits and usage </Card> </CardGroup>

post/api/v1/voice/validate

Request body

voiceUrlstring required

The original recording URL uploaded by the user [Required]

vocalStartSinteger required

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

vocalEndSinteger required

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

languagestring

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).

callBackUrlstring

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

codeinteger required

msgstring required