跳转到主要内容
POST
/
api
/
v1
/
voice
/
validate
Suno Voice生成验证短句接口
curl --request POST \
  --url https://api.example.com/api/v1/voice/validate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "voiceUrl": "https://example.com/audio/user_voice.mp3",
  "vocalStartS": 0,
  "vocalEndS": 10,
  "language": "en",
  "callBackUrl": "https://example.com/callback/suno/voice_prepare"
}
'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "xxx_task_id_xxx"
  }
}

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.

​
使用指南

  • 提交源录音 URL，以及用于创建音色的人声片段范围。
  • 接口会返回 taskId，后续可用它查询生成的验证短句。
  • 如果传入 callBackUrl，系统会在验证短句生成完成或任务失败时发送 POST 回调。回调地址必须可公网访问，并在 15 秒内返回 HTTP 200。
  • 获取 validateInfo 后，让用户录制该短句并上传验证音频，再调用音色生成接口。为获得更佳的音色生成效果，建议采用演唱方式录制。

​
流程

  1. 上传或托管源音频，确保 voiceUrl 可公开访问。
  2. 使用 vocalStartS 和 vocalEndS 选择干净的人声片段。
  3. 提交验证短句任务，并保存返回的 taskId。
  4. 通过查询接口或回调等待 validateInfo。
  5. 录制用户完成验证短句的音频，然后调用自建音色生成接口。为获得更佳的音色生成效果，建议采用演唱方式录制。

​
回调

验证短句回调

查看验证短句生成完成或失败时发送的回调格式

​
开发者注意事项

  • vocalEndS 必须大于 vocalStartS。
  • 建议选择人声清晰、背景噪音少的片段，以提高验证效果。
  • language 用于控制验证短句语言，支持 en、zh、es、fr、pt、de、ja、ko、hi、ru。

授权

​
Authorization
string
header
必填

API 认证说明

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

获取 API Key

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

使用方式

在请求头中添加：

Authorization: Bearer YOUR_API_KEY

注意：

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

请求体

application/json
​
voiceUrl
string
必填

用户上传的原始录音URL[必填]

​
vocalStartS
integer
必填

截取人声开始秒数[必填]

​
vocalEndS
integer
必填

截取人声结束秒数，必须大于vocal_start_s[必填]

​
language
string

验证短句语言,支持的语言有: en英文，zh中文，es西班牙语，fr法语，pt葡萄牙语言，de德语，ja日语，ko韩语，hi印地语，ru俄语

​
callBackUrl
string

用于接收验证短句生成结果的回调地址。验证短句生成完成（status: wait_validating）或任务失败时，系统会向该地址发送 POST 请求。该地址必须可公网访问，并在 15 秒内返回 HTTP 200。回调数据格式请参考 验证短句回调。

响应

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