v1
latestOpenAPI 3.0.02026-07-26355125.0 KBdocs/en/Market/Suno API/voice
suno接口/voice
Suno Voice Get Verification Phrase API
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 should record 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 record verification audio
- success: the validation and voice creation flow has completed
Continue the Flow
After receiving validateInfo, record or upload audio of the user performing that phrase and submit it to the voice generation endpoint. For best voice generation results, singing is recommended.
<Card title="Generate Voice" icon="lucide-mic" href="/suno-api/suno-voice-generate"
Submit the user's verification audio to generate the final custom voice </Card>
Related resources
<CardGroup cols={2}> <Card title="Generate Validation Phrase" icon="lucide-file-audio" href="/suno-api/suno-voice-validate"> Create a validation phrase from source audio </Card> <Card title="Regenerate Validation Phrase" icon="lucide-refresh-cw" href="/suno-api/suno-voice-regenerate"> Generate a new phrase for an existing task </Card> </CardGroup>get/api/v1/voice/validate-info
Query parameters
taskIdstring
任务id