Suno v4.5 API
Suno v4.5 は OmniaKey 初の音楽ルートです。スタイルを説明して歌詞を任せることも、歌詞とスタイルを一緒に送ることもでき、完成した 1 曲が画像や動画と同じ非同期メディア API で返ります。
- モデルID
- suno-v4.5
- プロバイダー
- Suno
- 種別
- AIオーディオ
- 成功した呼び出し 1 回あたり
- $0.30
- 最終確認済み
- 2026-09-15
プレイグラウンド
このモデルは OmniaKey アカウントでご利用いただけます。
01
向いている用途
Suno v4.5 はデモ、BGM、ジングル、歌詞の下書きに向いており、1 回の生成で $0.30 です。生成ごとに完成した 1 曲が返り、歌詞の有無にかかわらず課金は 1 回だけです。
02
できること
テキストから音楽へ
suno-v4.5
スタイルの説明と任意の歌詞から完成した楽曲を生成します。
03
呼び出し方
メディアモデルは非同期で動作します。タスクを作成し、完了までポーリングしてから、署名付きアセット URL をダウンロードします。
# 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)"04
料金
音楽ジョブはトークンではなく、成功した生成ごとに課金されます。失敗またはキャンセルされたジョブは自動的に返金されます。
$0.301 回あたり
よくある質問
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 1 回あたり を課金します。作成時に前払い残高からその金額が事前に差し引かれ、失敗またはキャンセルされたジョブは自動的に返金されます。
なぜ API は楽曲ではなくタスク id を返すのですか?
音楽のレンダリングには約30秒から数分かかるため、OmniaKey はすべてのオーディオルートを同じ非同期ライフサイクルで処理します。GET /v1/media/tasks/{id} をステータスが succeeded になるまでポーリングし、署名付きアセット URL を読み取ります。
