Skip to main content
基于您自己的音频创建个性化的音乐模型。该流程需要三个步骤:prepare(创建会话)→ upload(上传训练音频,至少 6 个)→ create(提交训练)。

工作流程


第一步:Prepare — 创建会话

创建会话并绑定账户。所有后续的上传和创建调用都会自动使用同一账户。

请求

无需请求体。

响应

sessionId 是整个工作流程的唯一标识符。请保存它以用于后续步骤。
参见 Prepare API 参考 →

第二步: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 很少失败,因为它只创建会话并绑定账户。

重要说明

create 步骤消耗 100 积分。请在提交前确保所有上传的片段都正确无误。
  • 同一账户保证:prepare / upload / create 自动使用相同的 Suno 账户 — 无需手动指定。
  • 积分:create 步骤消耗 100 积分。upload 步骤也会根据任务定价配置产生少量积分费用。
  • ClipId 验证:create 请求中的所有 clipIds 必须来自当前会话中的上传,否则会返回 400 错误。
  • 并行上传:多个上传请求可以并发发送,不会产生冲突。
  • 模型限制:每个定制账户可创建的模型数量有上限,由管理员配置。