v1
latestOpenAPI 3.0.02026-07-26355125.0 KBdocs/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