v1

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

Suno Voice Regenerate Verification Phrase

Regenerate the validation phrase for an existing Suno Voice task.

Use this endpoint when the previous validation phrase failed, expired, or the user needs a new phrase to record. Submit the existing taskId; the system will start a new validation phrase generation task and return a task ID for polling.

Query Task Status

After submitting the regeneration task, check the new validation phrase result 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 regenerated validation phrase task status </Card>

Continue the Flow

Once the regenerated phrase is ready, ask the user to record the new phrase and submit the verification audio 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"

Continue custom voice generation with the newly recorded verification audio </Card>

Related resources

<CardGroup cols={2}> <Card title="Generate Validation Phrase" icon="lucide-file-audio" href="/suno-api/suno-voice-validate"> Start the validation phrase flow from source audio </Card> <Card title="Get Voice Record" icon="lucide-list-checks" href="/suno-api/suno-voice-record-info"> Query the final custom voice generation result </Card> </CardGroup>
post/api/v1/voice/regenerate

Request body

taskIdstring required

Task ID

calBackUrlstring required

Callback URL used to receive regenerated validation phrase results. Note that this endpoint uses the field name calBackUrl. The system sends a POST request when the new 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 Regenerated Validation Phrase Callbacks.

Response

codeinteger required
msgstring required