跳转到主要内容
POST
/
api
/
v1
/
voice
/
regenerate
Suno Voice 重新生成验证短句
curl --request POST \
  --url https://api.example.com/api/v1/voice/regenerate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "taskId": "xxxxxxx",
  "calBackUrl": "https://example.com/callback/suno/voice_regenerate"
}
'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "xxx_task_id_xxx"
  }
}

​
使用指南

  • 当之前的验证短句失败、过期，或用户需要新的短句时使用此接口。
  • 提交音色验证流程中已有的 taskId。
  • API 源数据中回调地址字段名为 calBackUrl。系统会在重新生成的验证短句完成或任务失败时发送 POST 回调。回调地址必须可公网访问，并在 15 秒内返回 HTTP 200。
  • 使用返回的 taskId 再次查询新的验证短句结果。

​
流程

  1. 提交已有验证任务 ID。
  2. 保存接口返回的 taskId。
  3. 通过查询接口或回调等待重新生成的 validateInfo。
  4. 让用户录制新的验证短句，并将验证音频提交到音色生成接口。为获得更佳的音色生成效果，建议采用演唱方式录制。

​
回调

重新生成验证短句回调

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

​
开发者注意事项

  • 请确保重新生成的短句和后续验证录音属于同一个任务流程。
  • 如果短句反复生成失败，建议选择更清晰的人声片段并重新开始验证步骤。

授权

​
Authorization
string
header
必填

API 认证说明

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

获取 API Key

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

使用方式

在请求头中添加：

Authorization: Bearer YOUR_API_KEY

注意：

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

请求体

application/json
​
taskId
string
必填

任务id

​
calBackUrl
string
必填

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

响应

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