Suno API ドキュメント — プロンプトから音楽を生成（V5 / V5.5）、料金付き

Sunoは最高水準のAI音楽モデルです。テキストプロンプトからボーカル、歌詞、伴奏を含む完全な楽曲を生成します。Suno API（Kunavo上のSuno V5およびV5.5）は、POST /v1/audio/musicを通じてこれをプログラムから実行し、1つのBearerトークンでホストされた音声トラックを返します。これは実用向けのドキュメントです。リクエスト形式、料金、本番環境向けの非同期パターンを説明します。

Suno APIを呼び出す

/app/keysでキーを生成し、プロンプトをPOSTします。1回のリクエストで約2種類のトラックバリエーションが返され、生成には数十秒から約2分かかります：

import requests

# Music generation is a POST to /v1/audio/music. One request returns
# ~2 track variations; generation takes tens of seconds to a couple of minutes.
resp = requests.post(
    "https://api.kunavo.com/v1/audio/music",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "suno-v5",                 # or suno-v5-5
        "prompt": "uplifting lo-fi hip hop with mellow piano and vinyl crackle",
        "instrumental": False,              # set True to skip vocals
    },
    timeout=300,
)
for track in resp.json()["data"]:
    print(track["url"])

完全なパラメーターと非同期タスクのライフサイクルは、音楽APIリファレンスにあります。

料金

Sunoは生成リクエスト単位で課金されます（トラック単位ではありません）。そのため、返される約2種類のバリエーションは1回分の課金です。現在の料金は各モデルページに掲載されています。Suno自体はリクエスト単位のAPI価格を公開していません。独自APIはパートナー限定プログラムで、公開料金がないため、表にはKunavoが請求する料金だけを示しています。

$10の最低トップアップ額から従量課金で利用でき、残高は失効せず、失敗した生成には課金されません。より広い利用量はコスト計算ツールで見積もってください。

カスタムモード：独自の歌詞

通常のプロンプトの代わりに、lyrics、styleの説明、titleを指定して完全に制御するか、instrumental: trueを設定してボーカルを完全に省略します：

# Custom mode: supply your own lyrics + a style, instead of a plain prompt.
curl https://api.kunavo.com/v1/audio/music \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v5-5",
    "lyrics": "[Verse]\nCity lights blur into the rain...",
    "style": "synthwave, 110 bpm, female vocal",
    "title": "Neon Rain"
  }'

本番環境では非同期処理

音楽生成は即時ではないため、大規模に利用する場合は接続を保持したままにせず、タスクを送信して結果をポーリングしてください。音楽ドキュメントでは、タスクのライフサイクル、ポーリング、Webhook配信を説明しています。結果URLは完了後も永続します。

KunavoとSunoを直接利用する場合の比較

Suno独自の製品は、従量課金の従量制APIではなく、クレジット枠付きのサブスクリプションです。これこそが、開発者がそもそも「Suno API」を探す理由です：

製品内で音楽を生成するなら、従量課金と実際のエンドポイントが重要です。人がブラウザーで手作業でトラックを作るなら、Suno独自のサブスクリプションのほうが簡単です。

Suno APIとUdio API

Udioはもう1つの主要な音楽生成ファミリーで、「Udio API」は並行してよく検索される語です。現在の実用上の違いは、UdioのAPIアクセスが安定した公開価格のない実験的なサードパーティー経路を通じて提供されるのに対し、Kunavo上のSuno V5 / V5.5は、公開された固定料金（生成リクエストあたり$0.09）のサポート対象エンドポイントである点です。本番環境で信頼できる音楽生成が必要なら、ここではSuno V5 APIが安定した経路です。安定した上流サービスが存在するようになれば、Udioも評価します。

音楽の先へ

同じキーで、テキスト（Claude、GPT）、画像（Nano Banana、GPT-Image-2）、動画（Veo 3、Seedance 2、Wan 2.7）にアクセスできます。そのため、LLMで台本を書き、ビジュアルを生成し、Sunoのサウンドトラックを追加するという一連のパイプラインを構築できます。画像→動画→音楽のワークフローについては、マルチモーダルAIガイドをご覧ください。

よくある質問