模型端点 · POST /v2/generate

Suno v6 API

通过一个异步 REST 端点生成完整歌曲——人声、歌词与配器。chirp-v6 系列包含旗舰 Suno v6 模型、快速经济档和更具实验性的变体,按请求以积分计费。

每首歌 10–12 积分 · 1 USD = 100 积分

Suno v6 API 能为你做什么

Suno v6 API 让服务端应用仅凭一段文本提示或自定义歌词就能生成完整歌曲。你从 chirp-v6 系列中选择模型,发送一次 POST 请求,拿到异步任务的 workId——人声、结构与配器都由模型完成。

三个现有模型共用同一个端点。chirp-v6 是面向正式发布的旗舰模型;chirp-v6-mini 是快速经济的档位,适合大批量或原型工作负载;chirp-v6-wild 是更实验性的变体,适合更自由大胆的编曲。每个结果都会在 model_name 中报告实际生成音频的模型,因此你可以安全地迁移旧集成。

快速上手:创建并轮询任务

向 /v2/generate 发送带鉴权的 POST,保存返回的 workId,然后轮询 /v2/feed 直到任务完成——或传入 callback_url 等待 webhook。

curl
curl -X POST "https://udioapi.pro/api/v2/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "chirp-v6",
    "prompt": "Verse 1: Walking down the street, feeling so free\nChorus: Summer dreams are calling me",
    "style": "pop, upbeat, electronic, 120 bpm",
    "title": "Summer Dreams",
    "make_instrumental": false
  }'

curl -X GET "https://udioapi.pro/api/v2/feed?workId=YOUR_WORK_ID"

生成为异步流程。每 5–10 秒轮询一次并设置总超时上限,及时下载音频 URL——媒体链接是临时的。

Suno v6 模型与价格

三个模型均可用于 generate、upload-cover 与 extend。价格为每次请求;1 USD 可兑换 100 积分。

模型积分≈ USD定位
chirp-v612≈ $0.12旗舰——为正式发布提供最高保真度歌曲
chirp-v6-mini10≈ $0.10快速经济——批量任务与原型开发
chirp-v6-wild12≈ $0.12更具实验性——大胆自由的编曲

旧版标识符仍按历史价格可用:chirp-v5 与 chirp-v5-5 由 chirp-v6 提供;chirp-v3-5、chirp-v4-0、chirp-v4-5、chirp-v4-5-plus 与 chirp-v4-5-all 由 chirp-v6-mini 提供。省略 model 字段时按 5 积分基础档计费,由 chirp-v6-mini 提供。

工作原理

从 API 密钥到可播放音轨,只需四步。

  1. 1

    创建 API 密钥

    登录后打开控制台复制密钥。将其保存在服务端密钥中——切勿放进浏览器代码。

  2. 2

    提交任务

    携带模型与提示词向 /v2/generate 发起 POST。响应返回异步任务的 workId。

  3. 3

    轮询或接收回调

    每 5–10 秒调用 GET /v2/feed?workId=...,或传入 callback_url 处理完成 webhook。

  4. 4

    下载音频

    状态为 SUCCESS 时,feed 响应包含临时音频 URL。请把文件保存到自己的存储中。

简单的积分计费

1 USD 可兑换 100 积分。chirp-v6 每首歌约 $0.12,chirp-v6-mini 约 $0.10——只按你选择的模型付费,使用 API 无需订阅或席位。

按需购买的积分永不过期。被拒绝或失败的请求会自动退款。

限制与说明

  • 所有生成端点均为异步;POST 响应包含 workId,而不是音频。
  • 使用有限次重试轮询 /v2/feed,或用 callback_url 做服务器到服务器交付。
  • chirp-v5 与 chirp-v5-5 请求产出 chirp-v6 音频;更早的旧版标识符产出 chirp-v6-mini。
  • 媒体 URL 是临时的——请下载并把结果持久化到自己的存储。
  • 请将提示词、标题与风格控制在文档限制内,超长值会被截断。

udioapi.pro 是独立的第三方服务,与 Suno、Udio 或 MiniMax 均无关联,未获其认可,也不由其运营。

Suno v6 API 常见问题

关于模型、计费与异步工作流的解答。

这是 Suno 官方 API 吗?

不是。udioapi.pro 是独立的第三方 API 服务,拥有自己的端点、账户、积分、条款与支持,与 Suno 或 Udio 无关联,未获其认可,也不由其运营。

应该先用哪个 Suno v6 模型?

原型与大批量任务用 chirp-v6-mini——10 积分的快速经济档;需要旗舰质量时切换到 chirp-v6(12 积分),想要更实验性的输出则用 chirp-v6-wild。

一次请求多少钱?

chirp-v6 与 chirp-v6-wild 每次请求 12 积分,chirp-v6-mini 为 10 积分。按 1 USD = 100 积分折算约为每首歌 $0.10–$0.12。省略 model 字段按 5 积分基础档计费,由 chirp-v6-mini 提供。

如何拿到生成的音频?

每个被接受的请求都返回一个 workId。每 5–10 秒轮询 GET /v2/feed?workId=...,直到状态为 SUCCESS;或传入 callback_url 接收 webhook。feed 响应中即包含音频 URL。

旧的模型标识符还能用吗?

可以。chirp-v5 与 chirp-v5-5 由 chirp-v6 提供,chirp-v3-5 至 chirp-v4-5-all 由 chirp-v6-mini 提供——均按历史价格计费。model_name 会报告实际生成音频的模型。

可以延长或翻唱已生成的歌曲吗?

可以——chirp-v6 系列在 generate、upload-cover 与 extend 上均可用。延长按原音轨的模型价格计费,被拒绝或失败的请求会自动退款。