已上线模型
Suno 开发指南
更新于 2026-07-29
Suno 已在 Roko API 上线。本页提供开发接入所需的模型 ID、定价快照与可复制示例;产品介绍与实时价格见 Suno 模型页。
简介
- 供应商:Unknown
- 类型:音频生成
- 档位数:1
- 端点标签:openai
Suno 音乐生成使用异步任务接口:提交 `POST /v1/audios/tasks` 后,通过 `GET /v1/tasks/{task_id}` 查询进度和结果。
可用档位与价格
请求里的 model 必须使用下表中的模型 ID(区分大小写)。
| 档位 | 模型 ID | 单次价格 | 输出 | 上下文 |
|---|---|---|---|---|
| V5.5 | suno-v5.5 | $0.0600 / 次 | — | — |
价格为构建时快照;以控制台与 定价页 实时数据为准。
Base URL 与认证
export OPENAI_BASE_URL="https://api.rokoapi.com/v1"
export OPENAI_API_KEY="sk-..."
所有请求携带 Authorization: Bearer $OPENAI_API_KEY。密钥在
控制台密钥页 创建。
快速开始
cURL
curl https://api.rokoapi.com/v1/audios/tasks \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v5.5",
"action": "generate",
"mode": "easy",
"prompt": "轻快的夏日流行歌曲,女声,带有明亮的吉他"
}' Python(requests)
import requests
base_url = "https://api.rokoapi.com/v1"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
task = requests.post(
f"{base_url}/audios/tasks",
headers=headers,
json={
"model": "suno-v5.5",
"action": "generate",
"mode": "easy",
"prompt": "轻快的夏日流行歌曲,女声,带有明亮的吉他",
},
).json()
result = requests.get(
f"{base_url}/tasks/{task['id']}",
headers=headers,
).json()
print(result) 常用参数
| 参数 | 说明 |
|---|---|
model |
上表 Suno 模型 ID,例如 suno-v5.5 |
action | generate 生成歌曲;extend 续写已有片段
|
mode | easy 使用自然语言描述;advanced
可分别传歌词与风格
|
prompt / lyrics / style | 歌曲描述、歌词和风格;必填规则取决于 mode |
instrumental / title | 是否生成纯音乐,以及可选标题 |
提交成功会返回公开任务 ID。请定期请求 GET /v1/tasks/{task_id}
,直到状态变为 completed 或
failed;不要使用聊天或流式端点调用异步生成模型。
完整协议见音频生成任务。
注意事项
- 请使用本页列出的已上线模型 ID;未开通或已下线的名称会返回模型不可用类错误。
- 余额不足、分组无权限时通常表现为 403;请检查账户额度与密钥所属分组。
- 多模态、工具调用、缓存计费等能力因上游与渠道配置而异,以实际响应与控制台说明为准。