已上线模型

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;请检查账户额度与密钥所属分组。
  • 多模态、工具调用、缓存计费等能力因上游与渠道配置而异,以实际响应与控制台说明为准。