音频Sunomusiclyricstext-to-music

Suno V6

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.

模型 ID: suno-v6

Playground

供应商

Prompt / lyricsprompt

Custom modecustom_mode

Instrumentalinstrumental

Stylestyle

Titletitle

Exclude stylesnegative_tags

Vocal gendervocal_gender

Duration (s)duration

10 – 360

预计费用—

在代码中发送同样的请求 — API 文档

本次请求的各供应商报价

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

结果

生成结果会显示在这里。

各供应商价格

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

供应商	规格	价格（美元）	积分
EvoLink	全部规格	~~$0.118~~省 10%$0.106 / 次	27 / 次

API 文档

接口列表

Base URL: https://01router.com/api/v1

POST/generations创建生成任务（扣积分）

GET/generations/{id}查询任务；运行中会向上游拉取状态

POST/quote对所有供应商报价（不扣费，无需 Key）

鉴权

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

Authorization: Bearer sk_xxxxxxxxxxxxxxxx

获取 API Key

请求体

参数名	类型	必填	说明
model	string	是	"suno-v6"
provider	string	否	指定供应商；不传则自动路由到最便宜的。可选： evolink
input	object	是	模型参数，字段见下方 input 字段表。

input 字段

统一参数适用于所有供应商；部分供应商支持的取值范围更窄，可通过报价接口或 Playground 查看。

参数名	类型	可选值	默认值
prompt Song description (simple mode) or lyrics (custom mode)	text	—	—
custom_mode Use your own lyrics, style and title	boolean	—	false
instrumental	boolean	—	false
style Custom mode only, e.g. "dream pop, female vocals"	string	—	—
title Custom mode only	string	—	—
negative_tags	string	—	—
vocal_gender	enum	m \| f	—
duration Custom mode only	integer	10 – 360	—

调用示例

curl https://01router.com/api/v1/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "suno-v6",
  "provider": "evolink",
  "input": {
    "prompt": "An upbeat synth-pop song about a road trip at sunset",
    "custom_mode": false,
    "instrumental": false
  }
}'

# poll until status is "succeeded" or "failed"
curl https://01router.com/api/v1/generations/<id> -H "Authorization: Bearer $API_KEY"

响应示例

传入模型 ID、统一输入参数，可选指定供应商 slug。接口立即返回任务 ID；同步类供应商的图片模型可能直接返回成功结果。

{
  "id": "gen_6f1c…",
  "object": "generation",
  "model": "suno-v6",
  "type": "audio",
  "provider": "evolink",
  "status": "processing",
  "input": {
    "prompt": "…",
    "custom_mode": false,
    "instrumental": false
  },
  "outputs": [],
  "error": null,
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-23T08:00:00.000Z",
  "completed_at": null
}

获取结果

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

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

{ "id": "gen_6f1c…", "model": "suno-v6", "status": "succeeded", "outputs": ["https://…"], … }

报价

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

curl https://01router.com/api/v1/quote -H "Content-Type: application/json" \
  -d '{"model":"suno-v6","input":{"prompt":"…","custom_mode":false,"instrumental":false}}'

鉴权、路由、计费与错误码详见网关 API 文档