docs.api.box
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
Support
Suno API
Common API文件上传API
Suno API
Common API文件上传API
  1. Suno Voice
  • API.box 文档
  • 快速开始
  • Generate Music
    • 音乐生成回调
    • 音乐延长回调
    • 上传并翻唱音频回调
    • 上传并扩展音频回调
    • 添加伴奏回调
    • 添加人声回调
    • 音乐封面生成回调
    • 替换音乐分区回调
    • 生成音乐
      POST
    • 延长音乐
      POST
    • 上传并翻唱音乐
      POST
    • 上传并扩展音乐
      POST
    • 添加伴奏
      POST
    • 添加人声
      POST
    • 获取音乐生成详情
      GET
    • 恢复音频
      POST
    • 获取恢复音频详情
      GET
    • 获取带时间戳的歌词
      POST
    • 提升音乐风格
      POST
    • 生成音乐封面
      POST
    • 替换音乐分区
      POST
    • 获取音乐封面详情
      GET
    • 生成 Persona
      POST
    • 混音生成
      POST
  • Suno Voice
    • Suno Voice 验证短句回调
    • Suno Voice 自建音色生成回调
    • Suno Voice 重新生成验证短句回调
    • Suno Voice 生成验证短句
      POST
    • Suno Voice 获取验证短句
      GET
    • Suno Voice 自建音色生成
      POST
    • Suno Voice 获取自建音色记录
      GET
    • Suno Voice 重新生成验证短句
      POST
    • Suno Voice 检查音色是否可用
      POST
  • Lyrics Generation
    • 歌词生成回调
    • 生成歌词
    • 获取歌词生成详情
  • Generate Sounds
    • 生成声音
  • WAV Conversion
    • WAV格式转换回调
    • 转换为WAV格式
    • 获取WAV转换详情
  • Vocal Removal
    • 音频分离回调
    • MIDI 生成回调
    • 人声与乐器分离
    • 获取音频分离详情
    • 从音频生成 MIDI
    • 获取 MIDI 生成详情
  • Music Video Generation
    • 音乐视频生成回调
    • 创建音乐视频
    • 获取音乐视频详情
  • Generate Speech
    • 生成语音
  1. Suno Voice

Suno Voice 验证短句回调

Suno Voice 验证短句任务完成或失败时,通过 POST 回调接收结果。
当提交验证短句任务并传入 callBackUrl 后,系统会在任务进入最终状态时向您的回调地址发送 POST 请求。

回调机制概述#

生产环境建议使用回调,减少对验证短句查询接口的轮询。

回调时机#

验证短句生成完成,等待用户录制验证音频
验证短句生成失败
任务处理过程中发生错误

回调方式#

HTTP 方法:POST
Content Type:application/json
超时时间:15 秒

回调请求格式#

验证短句生成完成回调
验证短句生成失败回调
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "xxx_task_id_xxx",
    "validateInfo": "请清晰录制这段验证短句。",
    "status": "wait_validating",
    "errorCode": 0,
    "errorMessage": ""
  }
}

字段说明#

code · integer · required
回调状态码。200 表示成功,非 200 表示任务失败或处理异常。
msg · string · required
回调状态消息。
data.taskId · string · required
验证短句生成接口返回的任务 ID。
data.validateInfo · string
验证短句文本。当 status 为 wait_validating 时返回。
data.status · string · required
任务状态。常见回调状态包括 wait_validating、processing_validate_fail 和 fail。
data.errorCode · integer
任务失败时返回的错误码。
data.errorMessage · string
任务失败时返回的详细错误信息。

接收回调示例#

Node.js

相关接口#

获取验证短句
使用 taskId 手动查询同一任务状态
Previous
混音生成
Next
Suno Voice 自建音色生成回调
Built with