Suno Voice Create Custom Voice API

POST

/api/v1/voice/generate

Generate a custom Suno Voice after the user reads the validation phrase.Submit the original validation task ID, the user's verification audio URL, and optional voice metadata such as voiceName, description, and style. The system will validate the recording and create a reusable custom voice.

Query Task Status #

After submitting the task, you can check the voice generation progress and obtain the final voiceId through the voice record query endpoint:

Get Voice Record

Learn how to check the custom voice generation status and obtain the generated voiceId

In the production environment, it is recommended to use the callBackUrl parameter to receive automatic notifications when the custom voice is generated, rather than polling the status endpoint.

Use the Generated Voice #

When the task succeeds, the response from the query or callback contains voiceId. You can use this ID in supported Suno generation endpoints that accept a custom voice.Related resources

Check Voice Availability

Verify whether a generated voice is available for use

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

taskId

string

required

Task ID

verifyUrl

string

required

The audio URL of the user reading the validation phrase [Required]

voiceName

string

optional

Voice name

description

string

optional

Voice description

style

string

optional

Voice style

calBackUrl

string

optional

Callback URL after the task is completed

Examples

Responses

🟢200

application/json

Generate Code

Bodyapplication/json

Generate Code

code

integer

required

msg

string

required

data

object

required

taskId

string

required

Task ID

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/generate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "taskId": "voice_create_001",
    "verifyUrl": "https://example.com/audio/verify_read.mp3",
    "voiceName": "My Voice",
    "description": "created from uploaded voice",
    "style": "Pop, Female Vocal",
    "callBackUrl": "https://example.com/callback/suno/voice_create"
}'

Response Response Example

{
    "code": 200,
    "msg": "success",
    "data": {
        "taskId": "xxx_task_id_xxx"
    }
}