工作流程
第一步:Prepare — 创建会话
创建会话并绑定账户。所有后续的上传和创建调用都会自动使用同一账户。请求
响应
sessionId 是整个工作流程的唯一标识符。请保存它以用于后续步骤。第二步:Upload — 上传训练音频
每次请求上传一个音频文件。每次调用是异步的,返回一个taskId。您需要轮询直到任务成功,从结果中获取 clipId。
在进入创建步骤之前,至少需要 6 个音频文件。多个上传可以并行进行。
请求
任务结果
成功后,result 包含片段信息,其中有一个 id 字段 — 这就是创建步骤所需的 clipId。
参见 Upload API 参考 →
第三步:Create — 提交训练
收集至少 6 个成功上传的 clipId 后,提交训练请求。这将消耗 100 积分,大约需要 2-3 分钟。请求
返回的
taskId 等于 sessionId。您可以使用其中任何一个进行轮询。result 包含定制模型详情。模型 ID 格式为 chirp-custom:<uuid>。
参见 Create API 参考 →
使用您的定制模型
训练完成后,在 Generate 端点中直接使用模型 ID:完整示例
故障恢复
- 上传失败:使用相同的
sessionId重试 — 无需重新 prepare。 - 创建失败(例如参数错误):使用相同的
sessionId和修正后的参数重试。系统会自动重置会话状态。 - Prepare 很少失败,因为它只创建会话并绑定账户。
重要说明
- 同一账户保证:prepare / upload / create 自动使用相同的 Suno 账户 — 无需手动指定。
- 积分:create 步骤消耗 100 积分。upload 步骤也会根据任务定价配置产生少量积分费用。
- ClipId 验证:create 请求中的所有
clipIds必须来自当前会话中的上传,否则会返回 400 错误。 - 并行上传:多个上传请求可以并发发送,不会产生冲突。
- 模型限制:每个定制账户可创建的模型数量有上限,由管理员配置。