Suno v4.5 API
AI 音频Suno v4.5 是 OmniaKey 上第一条可用的音乐路由:给出风格描述让模型自己写词,或者连同歌词一起提交,成品歌曲通过和图片、视频相同的异步媒体 API 返回。
- 每次成功调用$0.30
- 操作文生音乐
- 查看工具价格与计费规则
运行模型后,结果会显示在这里。
01
适用场景
Suno v4.5 是 OmniaKey 上第一条可用的音乐路由:给出风格描述让模型自己写词,或者连同歌词一起提交,成品歌曲通过和图片、视频相同的异步媒体 API 返回。
Suno v4.5 适合做 demo、背景音乐、广告短曲和歌词初稿,每次生成 $0.30。每次生成返回一首完整歌曲,无论是否自带歌词都只按一次计费。
02
能力范围
文生音乐
suno-v4.5
把风格描述和可选歌词变成一首完整歌曲。
03
深入了解
Suno v4.5 是 Suno 的音乐模型,在 OmniaKey 上的模型 ID 为 suno-v4.5。你可以只描述风格,也可以连同歌词一起提交,成品歌曲以 MP3 返回,走的是和图像模型相同的异步媒体任务接口。它是目录里两个 Suno ID 中较旧、单价较低的一个,单次价格比 Suno v6 低一档。
适合做 demo、视频背景垫乐、短广告曲和歌词初稿。在 input.prompt 里描述曲风,模型会自己写词,成品接近三分钟;把词放进 input.lyrics,歌曲长度就大致跟着你给的词走。parameters.mv 可以锁定旧的 v4.5 变体,例如 chirp-v4,适合必须沿用旧音色的系列。
2026 年 10 月 17 日第一次请求,我们要了一段安静的 lo-fi 纯音乐,返回的是 2:55、48 kHz 立体声、约 3.5 MB 的 MP3,之后四首也是每次请求一个文件的形态。带我们自己八句词的两首明显短于三分钟的纯音乐,所以时长要按输入来估,而不是按模型名来估。
视频背景垫乐
给产品短片或教程配一段纯音乐。把 parameters.instrumental 设为 true,并在 input.prompt 里写清乐器与速度;我们拿到的是 2:55 的 lo-fi 钢琴加黑胶噪点。在剪辑里裁切循环,而不是要求精确时长。
广告短曲与片头音
想要短钩子,就把风格写紧、词写短。用我们八句词生成的两首歌在 45 到 63 秒之间,适合做片头音效。速度与乐器写清楚,再从成品里剪出最好的一句。
带固定风格的歌词初稿
把自己写的主歌和副歌交进去,听某个风格怎么处理它们。parameters.style 或 parameters.tags 指定类型,parameters.title 决定文件名,parameters.mv 在客户要求沿用上一季音色时锁定旧变体。
04
实测记录
05
需要预留的限制
- 只提供 generate 一种操作。续写歌曲、只提交歌词和语音请求都会失败,失败任务不产出文件,所以一次生成就是一首歌。
- 时长跟着输入走:我们自己八句词出来的是 45 至 63 秒,而不是描述词换来的三分钟。要固定时长就写描述,不要写歌词。
- 进度数值可能整程停在 0。要轮询 status 字段,否则正在生成的歌看起来像卡死,容易被误取消。
- 下载会过期:签名 MP3 链接约一小时失效,任务记录保留 24 小时,评审周期更长就得自己保存文件。
07
来源与核验
指南更新于 2026-10-27。
08
接入方式
媒体模型采用异步任务:创建任务、轮询到完成,再下载签名后的资源地址。
# 1. Create the job. 202 Accepted; the body carries the task id,
# the pre-charged price, and a poll_url. Reuse one Idempotency-Key
# across retries so a timeout never starts a second paid job.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks \
-H "Authorization: Bearer $OMNIAKEY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: suno-v4.5-001" \
-d '{
"model": "suno-v4.5",
"type": "audio",
"operation": "generate",
"input": {"prompt": "a paper boat on a quiet lake at sunset"},
"parameters": {"title": "Paper Boats"}
}'
# 2. Description mode sends input.prompt alone and lets the model write
# the words. Custom lyrics mode adds input.lyrics plus the style:
# {"prompt": "indie folk", "lyrics": "[Verse] ..."} —
# parameters.style (or .tags) overrides the style, and
# parameters.instrumental: true drops the vocal entirely.
# 3. Poll GET /v1/media/tasks/{id} until status is
# succeeded | failed | canceled. Progress carries percent and stage.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks/TASK_ID \
-H "Authorization: Bearer $OMNIAKEY_API_KEY"
# 4. Download assets[0].url before expires_at, or poll again for a
# fresh signed URL. Failed and canceled jobs are refunded.
curl -sS -o out.mp3 "$(jq -r '.assets[0].url' result.json)"09
价格
音乐任务按成功生成次数计费,不按 Token 计费;失败或取消的任务会自动退款。
$0.30每次调用
更多来自 Suno 的模型
相关文章
常见问题
如何在 OmniaKey 上调用 Suno v4.5?
向 /v1/media/tasks 发送 POST,带上模型 ID、type 设为 "audio"、operation 设为 "generate"。描述模式只传 input.prompt;想用自己的歌词,再加上 input.lyrics。重试时复用同一个 Idempotency-Key,避免超时后再起一个付费任务。
Suno v4.5 如何收费?
Suno v4.5 每次成功生成计费 $0.30 每次调用。创建任务时会先从预付费余额中预扣该金额,失败或取消的任务会自动退款。
为什么接口返回的是任务 id,而不是歌曲?
音乐渲染大约需要三十秒到几分钟,所以 OmniaKey 把所有音频路由统一到同一套异步流程。轮询 GET /v1/media/tasks/{id} 直到状态变为 succeeded,再读取签名后的资源地址。
Suno v4.5 的歌曲怎么下载?
轮询任务直到 status 变成 succeeded,然后取 assets[0].url 立刻把 MP3 存到本地。签名链接约一小时过期,任务记录 24 小时后消失,评审拖久了就再查一次任务拿新链接。网页面板里的结果保留 30 天。
Suno v4.5 比 Suno v6 便宜吗?
便宜。目录把 suno-v4.5 的单次价格列在 suno-v6 之下一档,每次请求返回一首成品歌,带不带歌词都一样。OmniaKey 按模型页上的费率对任务扣费,失败会退回。当前数字在价格表里。
Suno v4.5 的歌有多长?
我们的测试里,一段描述生成的是 2:55 的纯音乐。用自己写的八句词时,歌曲在 45 至 63 秒之间,因为模型按你给的字数走。需要固定时长就写描述,不要写歌词。
怎么给 Suno v4.5 提交自己的歌词?
歌词放进 input.lyrics,类型放在 parameters.style 或 parameters.tags,文件名用 parameters.title 指定。一次请求只出一首歌,所以 parameters.n 必须是 1。歌词还会压缩时长,写三段结构之前先知道这一点。
Suno v4.5 能续写歌曲或生成语音吗?
不能。只有 generate 会被执行。续写已有歌曲、只提交歌词、语音请求都会失败,也不会返回文件。想要更长的作品,就分段生成再在剪辑软件里拼接,语音需求换用语音模型。
Suno v4.5 的歌能商用吗?
先看 Suno 的服务条款。免费方案生成的歌曲仅限个人非商业使用,Pro 和 Premier 订阅者才拥有自己歌曲的权利,而且 Suno 只允许将通过认可方式下载的歌曲用于商业用途。从接口拿到的文件同样受这些条款约束。
