Suno Voice Get Custom Voice Records

GET

/api/v1/voice/record-info

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:

Check Voice Availability

Check whether the custom voice generated by the task is available

Related resources

Generate Voice

Submit verification audio and create a custom voice

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

Query Params

Generate Code

taskId

string

optional

任务id

Responses

🟢200

application/json

Generate Code

Bodyapplication/json

Generate Code

code

integer

required

Response status code

msg

string

required

Response message

data

object

required

taskId

string

required

Task ID

voiceId

string

required

The voice ID generated by the Suno Voice Generate Verification Phrase API

status

enum<string>

required

Task status

Allowed values:

wait_processingWaiting for Processing

Task is waiting to be processedprocessing_validateProcessing Validation

Waiting for validation codeprocessing_validate_failValidation Processing Failed

Failed to obtain validation codewait_validatingWaiting for Verification

Waiting for user verificationsuccessSuccess

Task completed successfullyfailFailed

Task failed

errorCode

integer

required

Error code

errorMessage

string

required

Detailed error message if the task failed

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/record-info?taskId=undefined' \
--header 'Authorization: Bearer <token>'

Response Response Example

{
    "code": 200,
    "msg": "success",
    "data": {
        "taskId": "xxx_task_id_xxx",
        "voiceId": "xxx",
        "status": "wait_processing, processing_validate: waiting for validation code, processing_validate_fail: failed to obtain validation code, wait_validating: waiting for verification, success, fail",
        "errorCode": 500,
        "errorMessage": "xxxxx"
    }
}