支持的模型版本

更新于 2026-09-15 · Suno-API 团队

当前可用的普通生成模型

对客请求只使用下表中的平台模型名。

对客模型名 对客显示名称 用途 状态
suno-v6 Suno V6 普通生成默认模型 当前可用
suno-v6-wild Suno V6 Wild V6 Wild 变体 当前可用
suno-v6-mini Suno V6 Mini V6 Mini 变体 当前可用

默认推荐模型:suno-v6。

分轨说明

分轨是独立的固定能力,不需要客户填写或选择歌曲生成模型。调用分轨接口时只需提供源歌曲和分轨模式,例如 two 或 twelve;实际返回数量以接口响应为准。

模型参数

在生成类 API 中,model 通常是可选的:

简易生成示例

curl -X POST https://www.suno-api.io/api/music/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --max-time 300 \
  -d '{
    "description": "一首轻快的流行歌曲",
    "model": "suno-v6"
  }'

等待时间与超时(重要):生成接口是同步接口,响应返回时才代表订单已被受理并提交生成。实测多数请求 1–3 秒返回,约 10% 超过 30 秒,最长约 230 秒。请把客户端超时设置为 300 秒以上(示例中的 --max-time 300);未收到响应不等于没有生成,超时后请勿立即重试。详见新版 API 总览的「等待时间与超时设置」。

V6 变体示例

{
  "model": "suno-v6-wild",
  "description": "一首具有实验性结构的电子音乐"
}

已下线模型

以下模型已不再作为新建请求的当前可用选项:

历史歌曲和历史任务仍可能在查询结果中保留旧的 model_name 或 model_version,这不代表旧模型可以继续提交新任务。

为兼容仍在运行的旧客户端,如果请求里填写了已下线的模型名,服务端会直接把该次请求按当前默认模型 suno-v6 处理,并在任务记录中返回 suno-v6,不会返回“模型不可用”错误。建议尽快把请求示例更新为上表中的当前模型名。

查询模型列表

GET /v1/models 的普通歌曲模型至少应包含:

{
  "object": "list",
  "data": [
    { "id": "suno-v6", "object": "model", "owned_by": "suno" },
    { "id": "suno-v6-wild", "object": "model", "owned_by": "suno" },
    { "id": "suno-v6-mini", "object": "model", "owned_by": "suno" }
  ]
}

响应也可能包含歌词、兼容路由或平台内部的其他模型。它们不应与普通歌曲生成的 V6 模型列表混淆。

响应字段说明

查询结果中的 model_version、model 或 model_name 可能来自平台保存值或上游返回值:

相关文章

开始接入

注册后即可在控制台创建 API Key,0.6 元一次固定生成 2 首,下载不限次数。

免费注册 查看完整文档