Suno Voice Check Availability API

POST

/api/v1/voice/check-voice

Check whether a generated Suno custom voice is available.

Use this endpoint after voice generation completes to verify that the generated voice can be used in supported Suno generation APIs. Submit the related task ID and check the isAvailable value in the response.

When to Use

This endpoint is useful when you need to confirm voice availability before starting a music generation request that depends on the custom voice.

Get Voice Record

Query the voice generation task first to obtain the latest task status and generated voice information

Related resources

Generate Voice

Create a custom voice from verification audio

General API

View account credits and usage

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.kie.ai/api/v1/voice/check-voice' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "task_id": ""
}'

Response Example

{
    "code": 200,
    "msg": "success",
    "data": {
        "isAvailable": true
    }
}

Suno Voice Regenerate Verification Phrase

Suno Voice Check Availability API

When to Use#

Request

Responses

When to Use