跳转到主要内容
GET
/
api
/
v1
/
voice
/
validate-info
Suno Voice获取验证短句接口
curl --request GET \
  --url https://api.example.com/api/v1/voice/validate-info \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "xxx_task_id_xxx",
    "validateInfo": "Harmonies fill the air with joyful melodies tonight",
    "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 查询。
  • 当任务状态为 wait_validating 时,读取 validateInfo 并让用户录制该短句。
  • 如果任务失败,请根据 errorCodeerrorMessage 判断是否重试。

状态说明

状态含义
wait_processing任务等待处理中
processing_validate正在生成验证短句
processing_validate_fail验证短句生成失败
wait_validating短句已生成,等待用户录制验证音频验证
success完整音色创建流程已完成
fail任务失败

下一步

生成音色

提交验证音频并创建最终自建音色

授权

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
必填