Suno · 媒体 API

Suno v4.5 API

Suno v4.5 是 OmniaKey 上第一条可用的音乐路由：给出风格描述让模型自己写词，或者连同歌词一起提交，成品歌曲通过和图片、视频相同的异步媒体 API 返回。

获取 API Key 查看文档

模型 ID: suno-v4.5
提供商: Suno
类型: AI 音频
每次成功调用: $0.30
最近核验: 2026-09-15

适用场景

Suno v4.5 适合做 demo、背景音乐、广告短曲和歌词初稿，每次生成 $0.30。每次生成返回一首完整歌曲，无论是否自带歌词都只按一次计费。

能力范围

文生音乐

suno-v4.5

把风格描述和可选歌词变成一首完整歌曲。

接入方式

媒体模型采用异步任务：创建任务、轮询到完成，再下载签名后的资源地址。

创建、轮询、下载

# 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)"

价格

音乐任务按成功生成次数计费，不按 Token 计费；失败或取消的任务会自动退款。

每次成功调用

$0.30每次调用

常见问题

如何在 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，再读取签名后的资源地址。