跳转到主要内容
GET
/
api
/
v1
/
voice
/
record-info
Suno Voice获取自建音色记录
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:等待验证码,processing_validate_fail:获取验证码失败,wait_validating:等待验证,success,fail",
    "errorCode": 500,
    "errorMessage": "xxxxx"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.sunoapi.org/llms.txt

Use this file to discover all available pages before exploring further.

使用指南

  • 使用自建音色生成接口返回的 taskId 查询。
  • statussuccess 时,响应中会包含生成的 voiceId
  • 如果任务失败,请根据 errorCodeerrorMessage 判断是否需要重新验证或重新生成。

状态说明

状态含义
wait_processing任务等待处理中
processing_validate正在处理验证
processing_validate_fail验证失败
wait_validating等待验证完成
success音色已准备完成,可使用 voiceId
fail任务失败

相关接口

检查音色是否可用

确认生成的自建音色是否可用于支持的 Suno 生成接口

授权

Authorization
string
header
必填

API 认证说明

所有接口都需要通过 Bearer Token 方式进行认证。

获取 API Key

  1. 访问 API Key 管理页面 获取您的 API Key

使用方式

在请求头中添加:

Authorization: Bearer YOUR_API_KEY

注意:

  • 请妥善保管您的 API Key,不要泄露给他人
  • 如果怀疑 API Key 泄露,请立即在管理页面重置

查询参数

taskId
string

任务id

响应

200 - application/json
code
integer
必填
msg
string
必填
data
object
必填