v1

latestOpenAPI 3.0.02026-07-26355125.0 KB
docs/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

Response

codeinteger required
msgstring required