Skip to main content
POST
/
api
/
v1
/
voice
/
check-voice
Suno Voice Check Availability API
curl --request POST \
  --url https://api.example.com/api/v1/voice/check-voice \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "task_id": ""
}'
{
  "code": 200,
  "msg": "success",
  "data": {
    "isAvailable": true
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.api.box/llms.txt

Use this file to discover all available pages before exploring further.

​
Usage Guide

  • Use this endpoint after the custom voice generation task succeeds.
  • Submit the related task ID in task_id.
  • If isAvailable is true, the generated voice is ready for supported Suno generation workflows.

​
When to Use

Call this endpoint before starting a generation request that depends on a custom voice. It helps avoid submitting downstream tasks while the voice is still unavailable.

Get Custom Voice Record

Query the latest task status and generated voice information before checking availability

Authorizations

​
Authorization
string
header
required

API Authentication

All endpoints require authentication using Bearer Token.

Get API Key

  1. Visit the API Key Management Page to obtain your API Key

Usage

Add to request headers:

Authorization: Bearer YOUR_API_KEY

Note:

  • Keep your API Key secure and do not share it with others
  • If you suspect your API Key has been compromised, reset it immediately from the management page

Body

application/json
​
task_id
string
required

Task ID that needs to be checked

Response

200 - application/json
​
code
integer
required
​
msg
string
required
​
data
object
required