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 ********************

or

Body Params application/jsonRequired

Generate Code

task_id

string

required

Task ID that needs to be checked

Examples

Responses

🟢200

application/json

Generate Code

Bodyapplication/json

Generate Code

code

integer

required

msg

string

required

data

object

required

isAvailable

boolean

required

Request Request Example

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

cURLcURL-WindowsHttpiewgetPowerShell

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

Response Response Example

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