v1

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

Suno Voice Get Custom Voice Records

Query the custom Suno Voice generation result.

Use this endpoint with the taskId returned by the voice generation endpoint. When the task succeeds, the response contains voiceId, which can be used as the custom voice identifier in supported generation APIs.

Status Handling

Check the status field to determine the next action:

  • wait_processing, processing_validate, or wait_validating: the task is still being processed
  • success: the voice is ready, use voiceId for future generation requests
  • processing_validate_fail or fail: the task failed, check errorMessage for details

Voice Availability

After receiving a voiceId, you can use the voice availability endpoint to confirm whether the generated voice can be used:

<Card title="Check Voice Availability" icon="lucide-badge-check" href="/suno-api/suno-voice-check-voice"

Check whether the custom voice generated by the task is available </Card>

Related resources

<CardGroup cols={2}> <Card title="Generate Voice" icon="lucide-mic" href="/suno-api/suno-voice-generate"> Submit verification audio and create a custom voice </Card> <Card title="General API" icon="lucide-cog" href="/suno-api/get-remaining-credits"> View account credits and usage </Card> </CardGroup>
get/api/v1/voice/record-info

Query parameters

taskIdstring

任务id

Response

codeinteger required

Response status code

msgstring required

Response message