Suno API 文档——根据提示词生成音乐（V5 / V5.5），含价格

Suno 是业界领先的 AI 音乐模型——它根据文本提示生成包含人声、歌词和配器的完整歌曲。Suno API（Kunavo 上的 Suno V5 和 V5.5）通过POST /v1/audio/music以编程方式完成这一过程，并通过一个 bearer token 返回托管音轨。这是面向实际使用的文档：包括请求格式、价格，以及生产环境中的异步模式。

调用 Suno API

在/app/keys生成密钥，然后 POST 一个提示词。一次请求会返回约两个音轨变体；生成需要几十秒到几分钟：

import requests

# Music generation is a POST to /v1/audio/music. One request returns
# ~2 track variations; generation takes tens of seconds to a couple of minutes.
resp = requests.post(
    "https://api.kunavo.com/v1/audio/music",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "suno-v5",                 # or suno-v5-5
        "prompt": "uplifting lo-fi hip hop with mellow piano and vinyl crackle",
        "instrumental": False,              # set True to skip vocals
    },
    timeout=300,
)
for track in resp.json()["data"]:
    print(track["url"])

完整参数和异步任务生命周期请参阅音乐 API 参考。

定价

Suno 按每次生成请求计费，而不是按音轨计费，因此返回的约 2 个变体只产生一次费用。实时价格请查看各模型页面。Suno 自己没有公布按请求计费的 API 价格——其自有 API 是仅限合作伙伴的项目，没有公开费率——因此表格只展示 Kunavo 的收费。

最低充值$10即可按量付费，余额永不过期，失败的生成永不计费。使用成本计算器估算更大规模的工作量。

自定义模式：使用自己的歌词

不要只提供普通提示词，而是提供lyrics、style描述和title以实现全面控制，或设置instrumental: true以完全跳过人声：

# Custom mode: supply your own lyrics + a style, instead of a plain prompt.
curl https://api.kunavo.com/v1/audio/music \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v5-5",
    "lyrics": "[Verse]\nCity lights blur into the rain...",
    "style": "synthwave, 110 bpm, female vocal",
    "title": "Neon Rain"
  }'

在生产环境中使用异步调用

音乐生成不是即时完成的，因此在大规模使用时应提交任务并轮询结果，而不是一直占用连接——音乐文档介绍了任务生命周期、轮询和 webhook 传递。结果 URL 一旦完成便永久有效。

Kunavo 与直接使用 Suno 的比较

Suno 自有产品是带有额度的订阅服务，而不是按量付费的计量型 API——这正是开发者最终会搜索“Suno API”的根本原因：

如果您要在产品中生成音乐，计量计费和真实端点才是关键。如果由人坐在浏览器中手动制作音轨，Suno 自己的订阅是更简单的选择。

Suno API 与 Udio API

Udio 是另一大音乐生成系列，“Udio API”也是常见的平行搜索词。如今的实际区别是：Udio API 的访问依赖实验性的第三方路径，没有稳定的公开价格；而 Kunavo 上的 Suno V5 / V5.5 是受支持的端点，具有固定且公开的费率（每次生成请求$0.09）。如果您需要在生产环境中可靠地生成音乐，这里的Suno V5 API是稳定路线；我们会在 Udio 有稳定的上游服务后对其进行评估。

音乐之外

同一个密钥还可访问文本（Claude、GPT）、图像（Nano Banana、GPT-Image-2）和视频（Veo 3、Seedance 2、Wan 2.7），因此您可以串联完整流程：使用 LLM 编写脚本、生成视觉内容，再添加 Suno 配乐。请参阅多模态 AI 指南，了解图像 → 视频 → 音乐工作流。

常见问题