suno API
Suno 已通过 API in One 接入真实生产路由 /api/v1/audio/music,后端节点为 node7。一个 API Key 即可调用并按成功请求计费。
请求体中的 model 字段。
当前已实现的 BFF 路由。
输入类型:text
密钥由共享 Dashboard 管理。
可在支持的异步任务中使用 callback_url。
服务亮点
用市场页形式展示真实已接入能力,不复用外部平台的 SLA、折扣或账号流程。
当前页面只展示已在 /api/v1 中实现的端点。 /api/v1/audio/music
支持 callback_url,也可用任务状态接口查询结果。
充值、订单、积分余额和个人资料继续使用现有共享控制台与旧逻辑。
浏览器只持有 API in One Key,上游 Provider 调用由服务端处理。
调用契约
复制这些字段即可接入当前真实模型路由。
- Base URL
https://apiin.one客户端调用同源 API,服务端 BFF 转发到 Worker。- 鉴权
Authorization: Bearer <API_KEY>由现有 Dashboard API Keys 页面管理。- Model 字段
suno放在请求体 model 字段中。- 结果查询
/api/v1/tasks/{task_id}异步任务返回 task_id 后查询。- 计费入口
/billing/credits使用现有积分、订单和充值旧逻辑。
运行方式
该模型创建异步任务,返回 task_id 后通过真实状态接口取回结果。
API Console
像模型市场一样直接切换同端点真实模型、端点和语言,右侧示例由当前 live catalog 的 payload 生成。
curl --request POST \
--url https://apiin.one/api/v1/audio/music \
--header 'Authorization: Bearer <API_KEY>'
--header 'Content-Type: application/json' \
--data-raw '{
"model": "chirp-v4-5",
"prompt": "A cheerful pop song about summer days, with catchy melody and upbeat rhythm",
"style": "pop, upbeat",
"make_instrumental": false,
"title": "Summer Days"
}'/api/v1/tasks/{task_id}端点评估
基于当前真实 endpoint 下的已上线模型,快速判断成本、供应商覆盖和生产接入方式。
按基础积分从低到高排序。
支持 callback_url,也可用任务状态接口查询结果。
真实能力
以下能力来自当前已接入的模型配置和后端路由,不展示未上线 API。
稳定生产路由
Full 8-endpoint API suite: generate, extend, feed, cover, upload-cover, lyrics
统一接口
Use the same API in One key as the rest of the routed catalog
透明计费
Credit-based billing through the shared billing console
快速接入
Multiple model versions (v4, v4.5, v4.5-plus, v4.5-all, v5)
任务状态
Webhook support for real-time completion notifications
请求方式
浏览器端只调用同源 API,服务端 BFF 再转发到对应 Worker。
POST/api/v1/audio/music5-12 积分Generate original music with lyrics or instrumental output.
POST/api/v1/audio/music/extend5-12 积分Extend an existing completed track with new music.
GET/api/v1/audio/music/feed0 积分Poll task status and retrieve completed audio results.
POST/api/v1/audio/music/cover/generate1 积分Generate cover artwork for music tracks.
GET/api/v1/audio/music/cover/status0 积分Check cover artwork generation status.
POST/api/v1/audio/music/upload-cover/generate8-12 积分Upload audio and regenerate it as an AI cover.
GET/api/v1/audio/music/upload-cover/status0 积分Check uploaded audio cover generation status.
POST/api/v1/audio/music/timestamped-lyrics2 积分Return lyrics with word-level timestamps.
参数
promptstringMusic description (inspiration mode) or lyrics (custom mode). Max 5000 chars.
可选gpt_description_promptstringText description for inspiration mode. Max 400 chars for v4.
可选modelstringModel: chirp-v3-5 (5cr), chirp-v4-0 (8cr), chirp-v4-5 (10cr), chirp-v4-5-plus (10cr), chirp-v5/chirp-v5-5 (12cr)
可选 · 默认 chirp-v3-5stylestringMusic style/genre (custom mode). Max 1000 chars.
可选titlestringTrack title. Max 80–100 chars.
可选make_instrumentalbooleanGenerate instrumental only (no vocals)
可选 · 默认 falsegenderstringPreferred vocal gender: "male" or "female"
可选style_weightnumberStyle adherence strength (0–1)
可选weirdness_constraintnumberCreative deviation control (0–1)
可选audio_weightnumberAudio feature balance (0–1)
可选callback_urlstringWebhook URL for result notification
可选示例请求
curl -X POST https://apiin.one/api/v1/audio/music \
-H "Authorization: Bearer aio_your_api_key" \
-H "Content-Type: application/json" \
--data-raw '{
"model": "chirp-v4-5",
"prompt": "A cheerful pop song about summer days, with catchy melody and upbeat rhythm",
"style": "pop, upbeat",
"make_instrumental": false,
"title": "Summer Days"
}'同端点可切换模型
这些模型使用同一个已实现 BFF endpoint,可通过请求体中的 model 字段切换。
同端点模型对比
同一个真实路由下的模型差异,便于按成本、输入输出和后端节点选择。
接入流程
这些步骤基于当前真实路由和共享账号体系,不新增独立登录、支付或订单流程。
创建共享 API Key
在现有 Dashboard 创建密钥,充值、订单、积分和个人信息仍走共享控制台。
调用真实端点
使用当前页面列出的 endpoint、model id 和参数发送请求。 /api/v1/audio/music
查询任务状态
异步媒体和工具任务使用 /api/v1/tasks/{task_id} 查询结果;对话模型直接返回响应。
任务状态查询
图像、视频、音频和工具任务创建后,使用真实任务端点查询结果。
GET/api/v1/tasks/{task_id}查询生成任务状态和结果。价格
1–12 credits per request (~$0.01–$0.12)
使用场景
这些场景可通过当前模型和对应后端节点实现。
Generate original music from text prompts or custom lyrics
Extend existing tracks with new content or different styles
Upload audio files and create AI cover versions
Generate album cover images for tracks
Get word-level timestamped lyrics for karaoke/player UIs
Build AI-powered music creation tools and apps
常见问题
How much does the Suno API cost?
Credits depend on model and endpoint: chirp-v3-5 = 5cr, chirp-v4-0 = 8cr, chirp-v4.5 = 10cr, chirp-v5 = 12cr. Upload-cover = 8–12cr. Cover images = 1cr. Timestamped lyrics = 2cr.
What API endpoints are available?
8 endpoints: /api/v1/audio/music (create music), /api/v1/audio/music/extend, /api/v1/audio/music/feed, cover generate/status, upload-cover generate/status, and timestamped lyrics.
Can I extend an existing song?
Yes. Use /api/v1/audio/music/extend with a completed task ID. Supports inherit mode (seamless continuation) or custom mode (change style/lyrics).
Can I upload my own audio and create a cover?
Yes. Use /api/v1/audio/music/upload-cover/generate to upload audio (max 8 min) and generate an AI cover with new vocals, style, and lyrics.
What model versions are available?
chirp-v3-5, chirp-v4-0, chirp-v4-5, chirp-v4-5-plus, chirp-v5, and chirp-v5-5. Each version offers different quality tiers and pricing.
Do I need a separate Suno account?
Use the API in One key shown in your dashboard for this routed Suno API workflow.