01Router

Suno V6 API

Suno V6 music generation: full songs with vocals or instrumentals from a description, or your own lyrics and style in custom mode. Each request returns two tracks.

Suno·音频可用

低至$0.045/ 次$0.05省 10%

模型 IDsuno-v6

在 Playground 试用查看 API
musiclyricstext-to-music

输入

文本

输出

音频

供应商

4 家供应商

Vocal gender

m · f

Duration (s)

10 – 360

近 7 天表现 · 近期请求较少，暂无统计数据。

Suno V6 价格

价格按单位计费；未指定供应商时，会路由到支持该参数组合且价格最低的供应商。

规格价格（美元）
全部规格
$0.045 / 次
5 积分$0.05省 10%

接入前先试用 Suno V6

写代码之前，先测试生成效果、对比各供应商价格并预估费用。

供应商
音频
预计费用

输入

prompt
custom_mode
instrumental
style
title
negative_tags
vocal_gender
duration

结果

空闲
生成结果会显示在这里。

本次请求的各供应商报价

输入提示词即可对比各供应商价格。

Suno V6 提示词示例

可直接使用的提示词，一键载入 Playground 再调整。

来源
场景分类

共 7 条提示词

Road-trip summer pop

Pop

An upbeat summer pop song about driving the coast with friends, windows down, chasing the sunset. Bright synths, punchy drums and a big sing-along chorus.

Rainy-night lo-fi

Lo-fi

Mellow lo-fi hip hop for a rainy late night in the city: soft felt piano, vinyl crackle, brushed drums and a slow, relaxed groove.

Cinematic synthwave anthem

Synthwave

Lyrics about racing through a neon city at midnight and never looking back.

Acoustic coffee-shop folk

Folk

A warm acoustic folk song about a small coffee shop on a snowy morning. Fingerpicked guitar, light percussion, gentle male vocals and a hopeful bridge.

查看更多

Suno V6 API 文档

该模型的接口、请求字段与可直接运行的调用示例。

Base URL

https://01router.com/api/v1
llms.txt

快速开始

将 API_KEY 设为项目密钥，在服务端运行示例。示例中的媒体地址需替换为您自己的公开地址。

自动路由会选择支持当前请求的供应商。选择指定供应商，可查看它的参数约束和调用示例。

curl https://01router.com/api/v1/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "model": "suno-v6",
  "input": {
    "prompt": "Welcome back. Let us get started.",
    "custom_mode": false,
    "instrumental": false
  }
}
JSON

# Replace GENERATION_ID with the id returned above; poll until status is "succeeded" or "failed"
curl https://01router.com/api/v1/generations/GENERATION_ID -H "Authorization: Bearer $API_KEY"

接口列表

这里只列出当前模型相关的接口，路径已包含 /api/v1。点击接口可跳转到使用说明。

POST
/api/v1/generations

创建生成任务（扣积分） · 需要 API 密钥

GET
/api/v1/generations/{id}

查询任务；运行中会向上游拉取状态 · 需要 API 密钥

POST
/api/v1/generations/{id}/cancel

取消进行中的生成任务（退还积分） · 需要 API 密钥

POST
/api/v1/quote

对所有供应商报价（不扣费，无需 Key） · 公开 · 无需密钥

GET
/api/v1/models/suno-v6

查询单个模型 · 公开 · 无需密钥

鉴权

以 Bearer Token 方式发送 API Key，费用从 Key 所属账户的积分中扣除。

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
获取 API Key

输入参数

使用 Content-Type: application/json 发送请求。模型参数放在 input 中，model、provider、callback_url 放在最外层。

请求体

参数名类型必填说明
modelstring是"suno-v6"
providerstring否指定供应商；不传则自动路由到最便宜的。可选： kie | apimart | evolink | atlascloud
inputobject是模型参数，字段见下方 input 字段表。
callback_urlstring否可选的公开 HTTPS 回调地址，接收带签名的任务最终结果；仍可通过查询接口获取状态。

input · input 字段

必填字段已明确标记，其他字段省略时使用所列默认值。

参数名类型必填可选值默认值
prompt
Song description (simple mode) or lyrics (custom mode)
string否——
custom_mode
Use your own lyrics, style and title
boolean否—false
instrumentalboolean否—false
style
Custom mode only, e.g. "dream pop, female vocals"
string否——
title
Custom mode only
string否——
negative_tagsstring否——
vocal_genderstring否m | f—
duration
Custom mode only
integer否min: 10 · max: 360—
任务回调 →

输出结果

创建任务成功不代表生成完成。保存 id，查询到 succeeded 或 failed 后，读取 outputs 或 error。示例金额仅作说明，实际费用由请求决定。

queued→processing→succeeded / failed

提交后的响应

{
  "id": "gen_example",
  "object": "generation",
  "model": "suno-v6",
  "type": "audio",
  "provider": "kie",
  "status": "processing",
  "input": {
    "prompt": "Welcome back. Let us get started.",
    "custom_mode": false,
    "instrumental": false
  },
  "outputs": [],
  "error": null,
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": null
}

完成后的响应

{
  "id": "gen_example",
  "object": "generation",
  "model": "suno-v6",
  "type": "audio",
  "provider": "kie",
  "status": "succeeded",
  "input": {
    "prompt": "Welcome back. Let us get started.",
    "custom_mode": false,
    "instrumental": false
  },
  "outputs": [
    "https://example.com/output.wav"
  ],
  "error": null,
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": "2026-10-25T08:01:00.000Z"
}

响应字段

参数名类型必填说明
idstring是任务 ID，用于查询或取消任务。
objectstring是generation
modelstring是suno-v6
typestring是audio
providerstring是供应商
statusstring是queued → processing → succeeded / failed。进入任一终态后停止轮询。
inputobject是模型参数，字段见下方 input 字段表。
outputsstring[]是结果文件 URL 数组。处理中为空；成功后读取并及时下载保存。
errorstring | null是失败原因；无错误时为 null。
creditsnumber是本次请求扣除的积分。
price_usdnumber是本次请求的美元价格。
created_atstring是ISO 8601 格式的任务创建时间。
completed_atstring | null是ISO 8601 格式的完成时间；未完成时为 null。

获取结果

每隔几秒轮询，直到 status 为 succeeded 或 failed。输出链接由供应商托管，可能过期，请及时下载保存；也可以传 callback_url 接收推送。

curl "https://01router.com/api/v1/generations/GENERATION_ID" \
  -H "Authorization: Bearer $API_KEY"

queued → processing → succeeded / failed。进入任一终态后停止轮询。 结果文件 URL 数组。处理中为空；成功后读取并及时下载保存。

取消任务

取消取决于供应商支持情况和任务状态。确认取消后返回 status: failed、error: Canceled by user；不支持取消或已完成的任务返回 409 not_cancelable。

curl -X POST "https://01router.com/api/v1/generations/GENERATION_ID/cancel" \
  -H "Authorization: Bearer $API_KEY"

报价

请求体与创建任务相同。返回按价格排序的可用供应商，以及无法处理该请求的供应商及原因。

curl "https://01router.com/api/v1/quote" -H "Content-Type: application/json" --data-binary @- <<'JSON'
{
  "model": "suno-v6",
  "input": {
    "prompt": "Welcome back. Let us get started.",
    "custom_mode": false,
    "instrumental": false
  }
}
JSON

模型信息与参数

此公开接口返回模型参数，以及各供应商支持的参数约束和价格。

curl "https://01router.com/api/v1/models/suno-v6"

错误码

结合 HTTP 状态码和 error.message 排查。参数或认证错误需修正后再重试；生成任务失败则通过任务本身的 status 和 error 返回。

{
  "error": {
    "message": "Invalid or missing API key",
    "code": "unauthorized"
  }
}

400请求体或参数取值不合法

401缺少或无效的 API Key

402积分不足

404模型或任务不存在

409任务无法取消（已结束，或该供应商不支持取消）

429请求过于频繁，请稍后重试

502所有供应商都拒绝了任务（积分已退回）

鉴权、路由、计费与错误码详见 →

交给 AI 使用

将本模型文档交给编程助手：纯文本包含接口、输入约束、输出字段和请求示例。

打开 llms.txt

Suno V6 与同类模型对比

并排对比规格与起步价，选择前建议用同一提示词实测。

Suno V6Gemini 3.8 Flash TTSElevenLabs Eleven v4ElevenLabs Eleven v4 Turbo
厂商SunoGoogleElevenLabsElevenLabs
起步价$0.045 / 次$0.041 / 千字符$0.072 / 千字符$0.036 / 千字符
输入文本文本文本文本
供应商4 家供应商5 家供应商3 家供应商3 家供应商
Vocal genderm · f———
Duration (s)10 – 360———

Suno V6 API 常见问题

简单模式和自定义模式有什么区别？

简单模式下，prompt 是对歌曲的描述，歌词和编曲由 Suno 自动生成。开启 custom_mode 后，prompt 作为你自己写的歌词，还可以设置标题、风格标签、排除标签和目标时长。

Suno V6 生成的歌曲最长多长？

自定义模式下可以设置 10 到 360 秒。时长只是目标值，不保证精确；设置得很短时通常会生成一分钟左右。不设时长时，歌曲一般是几分钟。

一次请求会返回几首歌？

每次生成通常返回两首不同版本的歌曲，各自带封面图，方便你挑选更满意的一首。

可以指定歌手性别或生成纯音乐吗？

可以。把 instrumental 设为 true 即可生成无人声的纯音乐；vocal_gender 设为 m 或 f 可以倾向男声或女声，但不能百分之百保证。

在 01router 上 Suno V6 怎么计费？

按次计费，与歌曲长短无关。请求是异步的：先创建生成任务，再轮询直到成功。生成失败会自动退还积分。

相关模型

同一个 API Key 即可调用的其他模型。

音频 · Google

Gemini 3.8 Flash TTS

Google Gemini 3.8 Flash TTS: expressive speech in 30 voices with natural-language style control and inline vocal events like <laugh>.

低至 $0.041 / 千字符查看 API
音频 · ElevenLabs

ElevenLabs Eleven v4

ElevenLabs Eleven v4: expressive multilingual speech with audio tags, voice selection and delivery controls.

低至 $0.072 / 千字符查看 API
音频 · ElevenLabs

ElevenLabs Eleven v4 Turbo

ElevenLabs Eleven v4 Turbo: expressive multilingual speech with audio tags, voice selection and delivery controls.

低至 $0.036 / 千字符查看 API