Skip to main content
GET
/
api
/
v1
/
voice
/
record-info
Suno Voice Get Custom Voice Records
curl --request GET \
  --url https://api.example.com/api/v1/voice/record-info \
  --header 'Authorization: Bearer <token>'
{
  "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"
  }
}

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 the taskId returned by the custom voice generation API.
  • When status is success, the response contains the generated voiceId.
  • If the task fails, use errorCode and errorMessage to decide whether to retry validation or generation.

Status Handling

StatusMeaning
wait_processingTask is waiting to be processed
processing_validateVerification is being processed
processing_validate_failVerification failed
wait_validatingWaiting for validation to complete
successVoice is ready and voiceId can be used
failTask failed

Check Voice Availability

Confirm whether the generated custom voice is available for supported Suno generation APIs

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

Query Parameters

taskId
string

任务id

Response

200 - application/json
code
integer
required

Response status code

msg
string
required

Response message

data
object
required