Sign in

v1

latestOpenAPI 3.0.02026-07-26355125.0 KB
docs/en/Market/Suno API/voice
suno接口/voice

Suno Voice Create Custom Voice API

Generate a custom Suno Voice from verification audio for the validation phrase returned by the server.

Submit the original validation task ID, the user's verification audio URL, and optional voice metadata such as voiceName, description, and style. For best voice generation results, the verification audio should contain the user recording the exact validateInfo phrase in a singing voice rather than plain speech. The system will validate the recording and create a reusable custom voice.

Query Task Status

After submitting the task, you can check the voice generation progress and obtain the final voiceId through the voice record query endpoint:

<Card title="Get Voice Record" icon="lucide-search" href="/suno-api/suno-voice-record-info"

Learn how to check the custom voice generation status and obtain the generated voiceId </Card>

:::tip[] In the production environment, it is recommended to use the callBackUrl parameter to receive automatic notifications when the custom voice is generated, rather than polling the status endpoint. :::

Use the Generated Voice

When the task succeeds, the response from the query or callback contains voiceId. You can use this ID in supported Suno generation endpoints that accept a custom voice.

Related resources

<CardGroup cols={2}> <Card title="Check Voice Availability" icon="lucide-badge-check" href="/suno-api/suno-voice-check-voice"> Verify whether a generated voice is available for use </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/generate

Request body

taskIdstring required

Task ID

verifyUrlstring required

Audio URL for the user's recording of the validation phrase returned by the server; singing is recommended for best results [Required]

voiceNamestring

Voice name

descriptionstring

Voice description

stylestring

Voice style

singerSkillLevel'beginner' | 'intermediate' | 'advanced' | 'professional'

Singer skill level. Supported: beginner, intermediate, advanced, professional

callBackUrlstring

Callback URL used to receive custom voice generation results. When the task succeeds, the callback includes the generated voiceId; when it fails, it includes errorCode and errorMessage. The URL must be publicly accessible and return HTTP 200 within 15 seconds. For the payload format, see Custom Voice Generation Callbacks.

Response

codeinteger required
msgstring required