Suno V6 API 迁移指南：版本选择、字段改名与异步结果处理

reAPI 的 Suno V6 API 沿用现有音频端点，通过 version: "V6"、"V6_MINI" 或 "V6_WILD" 选择版本。迁移旧集成时，需要同时检查版本值和字段名：Suno 接口现已采用 snake_case，而旧版本值可能通过参数校验，却在生成阶段失败。^[1]

先用 model: "suno-music"，明确指定一个 V6 版本。保留异步提交和轮询流程，并保存返回的音轨标识，供后续编辑使用。先更新请求构造，再检查程序如何读取完成结果。将模型名称改为 suno-v6 并不是文档规定的版本选择方式。

要点速览

在 version 中传入 V6、V6_MINI 或 V6_WILD；歌曲生成的模型 ID 仍是 suno-music。^[1]
将旧 camelCase 字段改为文档规定的 snake_case，包括 custom_mode、negative_tags 和 audio_id。^[1]
停止提交已停用的 V4–V5.5 值。通过校验不等于仍能生成音频。^[1]
音乐方向明确时从 V6 开始；关注生成速度时评估 Mini；需要探索时尝试 Wild。这些建议依据 Suno 的产品定位，不是实测性能保证。^[2]
每次完成的歌曲生成按 $0.06 预算，包含两个版本。音效生成单独收取 13 credits。^[3]

Suno V6 API 请求有哪些变化

Suno 于 2026 年 9 月 9 日发布 V6，推出三个变体，并宣布逐步替换此前的模型代际。^[2] 对开发者而言，应先分清产品公告中的能力和当前接口允许提交的字段。

公告涉及更广泛的创作与编辑功能，但这不代表每项面向消费者的功能都能通过 reAPI 音频请求使用。例如，当前歌曲生成请求规定了文本控制及相关音频流程；不能因为公告提到图片或视频输入，就自行添加相应字段。实现时请以完整 Suno 参数文档为准。^[1]

Suno V6 文档列出了当前请求格式。model 选择操作，version 选择该操作使用的音乐模型。程序中应将这两个选择分开，避免选择 Mini 时误把歌曲生成切换成编辑操作。^[4]

这里使用的是 reAPI 服务。Suno 自己的公开开发者意向表仍描述为与精选合作伙伴开展探索，并不提供可自助领取的生产密钥。^[5]

V6、Suno V6 Mini 与 Suno V6 Wild：该传哪个值

根据你对下一次结果的要求选择变体。Suno 将旗舰版本定位于准确执行创作意图，将 Wild 定位于更难预测的探索，将 Mini 定位于更快、更高效的创作。下表是基于这些说明给出的使用建议。^[2]

API 值	适合从这里开始的情况	应在自己的任务中检查什么
`V6`	流派、编曲或歌词方向已经明确	结果是否足够贴合音乐要求
`V6_MINI`	迭代过程中更关注等待时间	从提交到完成的耗时，以及两首结果中是否有一首达到质量要求
`V6_WILD`	尚未确定编曲，需要探索	变化是否有用，还是增加了后期编辑工作

Mini 在这里不是更便宜的 API 档位。同一种操作在三个 V6 变体上的价格相同。因此，即使生成更快，减少的也是等待时间，而不是该次请求的挂牌费用。^[4] 本文没有开展受控延迟测试或听感对比。在测量自己的任务前，应把“更快”理解为 Suno 的产品定位。

公平比较时，保持提示词、模式和其他控制不变，只改 version，并检查两首返回结果。如果同时重写歌词或改变风格，就无法判断差异来自哪个改动。

每个任务都应记录所选版本。续写文档要求版本与源音轨匹配，因此用于新歌的版本选择器不应悄悄改写后续续写请求的版本。^[1]

Suno V6 与 V5.5：版本和字段名一起迁移

对已有集成而言，Suno V6 与 V5.5 的首要区别是请求能否完成。reAPI 文档将 V4、V4_5、V4_5PLUS、V4_5ALL、V5 和 V5_5 标为已停用。schema 保留这些值，但使用它们的请求会在生成阶段失败并退款。^[1]

这意味着存在两个不同的失败阶段。不支持的字段可能在提交时被拒绝；被接受的旧版本则可能先生成任务，随后任务才失败。只看 POST 的 HTTP 状态码，会漏掉后一种情况。

除了页面上的模型选择器，也要检查保存的预设和服务端默认值。界面可以显示“V6”，后台任务仍可能提交以前存下来的请求。

旧请求片段	当前写法
`"version": "V5_5"`	新歌生成使用 `"version": "V6"`
`"customMode": false`	`"custom_mode": false`
`"negativeTags": "metal"`	`"negative_tags": "metal"`
`"audioId": "…"`	引用音轨的操作使用 `"audio_id": "…"`

完整 Suno 文档记录了 2026 年 9 月 13 日的字段名变更。^[1] 应逐项更新请求对象；跨已保存结果和其他集成进行全局文本替换，可能误改本不需要迁移的内容。

对于新任务，先生成一个有效的 V6 源音轨，再测试依赖它的编辑。不能假设选择 V6 后，每个旧音轨标识都自动成为所有操作可用的源素材。

V6 页面覆盖的八个操作

V6 专页覆盖八个操作。它们共用 POST /api/v1/audio/generations，但必填输入各不相同。^[4]

操作	`model`	`version` 规则
生成歌曲	`suno-music`	必填
续写已生成音轨	`suno-extend`	必填；与源版本匹配
翻唱上传音频	`suno-upload-cover`	必填
续写上传音频	`suno-upload-extend`	必填；遵守源版本规则
加人声	`suno-add-vocals`	可选；默认 `V6`
加伴奏	`suno-add-instrumental`	可选；默认 `V6`
混合上传音频	`suno-mashup`	必填
生成音效	`suno-sounds`	必填

完整家族有 18 个异步操作。另外十个未列入 V6 专页，不代表十个都拒绝版本字段。suno-replace-section 可以接受现有 task_id 加 audio_id，或者 upload_url 加 version。上传音频分支必须提供版本；现有音轨分支必须省略。混合两个分支的字段属于无效请求。^[1]

如果程序给所有 Suno 请求统一附加 version，应移除这一假设，只在需要它的请求构造器中保留。WAV 转换、歌词生成和声音操作也各自有输入输出约定，不能简单复制歌曲请求。

发出第一次 V6 请求并等待音频

准备 reAPI 密钥、足以支付所选操作的额度，以及服务端保存凭证的位置。首次请求可以使用灵感模式，减少必填参数：prompt 描述歌曲，模型编写歌词。^[4]

curl https://reapi.ai/api/v1/audio/generations \
  -H "Authorization: Bearer $REAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-music",
    "version": "V6",
    "custom_mode": false,
    "instrumental": false,
    "prompt": "A dreamy synthwave track about driving through a neon city at midnight"
  }'

读取返回任务的 id，将它用于任务查询端点。下面的 TASK_ID 是实际值的占位符：

curl "https://reapi.ai/api/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer $REAPI_API_KEY"

提交成功不代表音频已完成。任务等待或处理中时继续轮询，失败时停止，status 为 completed 后读取输出。轮询不消耗 credits。^[4]

准备本文时，我们在生产环境 playground 中完成了一次 V6 生成。最终响应的 output.audio_urls 和 output.tracks 都有两项。这验证了该示例的输出数量，不构成性能或可靠性基准。

如果返回 output.tracks[].id，请将它与父任务 ID 一并保存。不能用音频 URL 替代 audio_id。文档保证音轨 URL 存在，但可能省略空的元数据字段，因此在开放后续操作前，应明确处理缺少歌词、时长或标识的情况。^[4]

需要指定准确歌词时，切换为自定义模式，并提供 style 和 title。Suno V6 的版本参数不会改变 custom_mode 的含义：时长控制仅在自定义模式生效，整数目标范围为 10–360 秒。^[4]

一次 V6 调用多少钱

2026 年 9 月 14 日核对的 Suno V6 价目表显示，歌曲生成每次完成请求收取 $0.06，即 60 credits，包含两首返回结果。除以二得到每首返回音轨 $0.03；这是算术折算，不是可单独购买的按首价格。^[3]

如果只采用其中一首，这首可用歌曲的成本仍是 $0.06。重新生成或执行后续操作会增加对应费用。选择 Mini，或在支持范围内生成较短歌曲，都不会降低该次费用。^[4]

音效不同：原始挂牌价为 $0.0125，按整数 credits 扣费后是 13 credits，相当于 $0.013。做预算应使用实际扣费 credits，不要将原始价格向下取整。^[3]

密钥配置见 Suno API Key 指南。其他操作的费用见完整价格表；官方是否提供开发者接入，则由官方 API 状态说明单独解释。

reAPI. Suno API reference. Retrieved September 14, 2026 from reapi.ai/docs/suno.
Suno. Introducing v6. Published September 9, 2026; retrieved September 14, 2026 from blog.suno.com/blog/introducing-v6.
reAPI. Suno V6 public rate card. Retrieved September 14, 2026 from reapi.ai/models/suno-v6.
reAPI. Suno V6: versions, parameters and billing. Retrieved September 14, 2026 from reapi.ai/docs/suno-v6.
Suno. Developer API intake form. Retrieved September 14, 2026 from sunomusic.typeform.com/apiform.

Suno V6 API 迁移指南：版本选择、字段改名与异步结果处理

要点速览

Suno V6 API 请求有哪些变化

V6、Suno V6 Mini 与 Suno V6 Wild：该传哪个值

Suno V6 与 V5.5：版本和字段名一起迁移

V6 页面覆盖的八个操作

发出第一次 V6 请求并等待音频

一次 V6 调用多少钱

常见问题

Suno V6 可以通过 API 使用吗？

三种变体有什么区别？

三个变体价格相同吗？

还能传 V5_5 吗？

哪些 V6 功能涉及集成修改？

version 可以省略吗？

音轨最长能生成多长？

每个操作都会返回两首歌吗？

迁移请求后，保留音轨标识

参考资料

作者

分类

更多文章

无限制AI视频生成器计划：先算好账本

AI 视频代理：构建批评循环实现质量保证

Claude Fable 5.1 迁移指南：修复工具选择 400 错误