跳转到主要内容
POST
验证并创建 Voice
能力按服务端配置逐项启用。未启用操作返回 503 且不创建任务;音乐积分扣除当前未启用。

调用步骤

使用同一次样本上传得到的任务 ID 和短句 ID,提交本人朗读该短句的录音 URL。
    1. 按下方示例准备输入,将占位地址和 ID 换成你有权使用的资源。
    1. 将 model 设为 suno_voice_create,参数放在 input 内。提交一次并保存返回的 task_id。
    1. 查询已保存的任务,或接收回调。任务仍在处理中时继续等待,不重新提交同一操作。
  • 保存 result.voice_id,复用前可通过 GET /api/v1/voices/{voice_id} 检查可用性。

创建任务

将model和input发送到统一任务入口;可在顶层传公开HTTPS callback_url。资源ID均为本账户的本站ID。当前音乐积分扣除未启用。

受理响应

HTTP 200仅表示受理。查询GET /api/v1/tasks/{task_id},直到data.status为succeeded或failed。成功后读取data.result;失败原因位于data.message。

参数速查

输入与限制

下方Schema列出支持字段、类型和基础限制;还须遵守“重要条件”,跨字段与来源资源校验不完全体现在JSON Schema中。未知参数会被拒绝。URL 参数仅接受公开 HTTPS 地址,不接受文件对象。

重要条件

  • 样本会话须已准备完成且未过期;phrase_id必须属于同一voice_upload_task_id。upload_url为本人朗读返回短句的新录音。24小时样本会话到期后须从suno_voice_upload重新开始。
  • 音频URL必须包含可读且时长大于零的MP3/WAV/FLAC/OGG/M4A/AAC音轨,每个文件最多500 MiB。URL须为可公开读取的HTTPS地址、端口443,不含用户名密码或私网地址,且应持续可访问直到任务结束。
  • 上传文件保留24小时,生成文件保留14天,任务详情保留30天;复用文件沿用原到期时间。有效Voice/Persona身份映射与任务日志清理分开处理,请及时下载需长期保存的文件。

结果 Schema

创建响应为 {code:200,msg:“success”,data:{task_id}},轮询 GET /api/v1/tasks/{task_id}。成功时 data.result 为符合下方 Schema 的对象,其他状态为 null;input 仍为 JSON 字符串。

相关流程

Voice 完整四步 文件上传 回调

授权

Authorization
string
header
必填

Every valid key can submit and query its own account. Revoked keys are rejected.

请求体

application/json
model
enum<string>
必填
可用选项:
suno_voice_create
示例:

"suno_voice_create"

input
object
必填
callback_url
string<uri>

Optional public HTTPS endpoint for signed completion callbacks; no redirects or private IPs.

响应

Accepted task. Poll the common task endpoint or use callback_url.

code
any
必填
msg
any
必填
data
object
必填