API リファレンス上級者向け更新日
POST/v1/music/generations

Suno 音楽生成 API

Suno V6 で説明文や自作の歌詞から楽曲を生成できます。歌声なしのインストゥルメンタルにも対応しています。

ベース URL は https://api.icodeeasy.cc です。接続が遅い場合は、同じパスのまま https://jp.icodeeasy.cc または https://sg.icodeeasy.cc に切り替えてください。送信と照会には Authorization: Bearer <API キー> が必要です。

生成タスクを送信する

bash
curl -X POST https://api.icodeeasy.cc/v1/music/generations \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: music-demo-001' \
  -d '{"model":"suno","version":"v6","prompt":"A warm jazz trio with brushed drums","instrumental":true,"audio_format":"mp3"}'

HTTP 202 が返ります。照会に使う data[0].task_id を保存してください。生成が完了すると楽曲を取得できます。

json
{"code":202,"data":[{"task_id":"mus_0123456789abcdef0123456789abcdef","status":"submitted","progress":0}]}

リクエストパラメーター

フィールド用途
modelsuno を指定します。省略できます。
versionv6(既定)、v6-wild、または v6-mini。
customfalse(既定)で説明文から生成し、true で自作の歌詞を使います。
prompt説明文は最大 3,000 文字、自作の歌詞は最大 5,000 文字です。custom と instrumental が両方とも true の場合は省略できます。
instrumentaltrue でインストゥルメンタルを生成します。
title / styleカスタムモードで省略可能な曲名とスタイルです。それぞれ最大 80 文字、1,000 文字です。
audio_formatmp3(既定)、m4a、または wav。

新しいタスクごとに、128 バイト以内の一意の Idempotency-Key を指定してください。送信がタイムアウトしたり応答を受信できなかったりした場合は、同じリクエスト本文とキーで再送すると既存のタスクを取得できます。異なる内容でキーを再利用すると HTTP 409 が返ります。

タスクを確認して楽曲をダウンロードする

bash
curl https://api.icodeeasy.cc/v1/music/tasks/mus_0123456789abcdef0123456789abcdef \
  -H "Authorization: Bearer $ICODEEASY_API_KEY"

約 10 秒おきに照会します。HTTP 200 が返ったら、data.status でタスクの状態を確認してください。

  • pending、submitted、processing の間は照会を続けてください。
  • completed になると、data.result.music から生成された全曲を取得できます。曲数は生成結果によって変わります。
  • failed は生成失敗を示します。unknown は受付を確認できなかった状態です。タスク ID と冪等キーを保存し、新しいキーでの自動再送は避けてください。

各曲には audio_index、秒単位の duration、再生用の署名付き audio_url が含まれます。download_url があればダウンロードに使用できます。title と lyrics が含まれることもあります。署名付きリンクは API キーなしで使用できるため、他人と共有しないでください。有効期限が切れたら、タスクを再照会してリンクを取得してください。

完了時のレスポンス例です。金額はフィールドの形式を示すための例です。

json
{
  "code": 200,
  "data": {
    "id": "mus_0123456789abcdef0123456789abcdef",
    "status": "completed",
    "model": "suno",
    "version": "v6",
    "progress": 100,
    "cost_rmb": 0.50,
    "result": {
      "music": [
        {
          "audio_index": 1,
          "duration": 138.5,
          "audio_url": "https://audio.example/track-1.mp3?signature=example",
          "download_url": "https://audio.example/track-1.mp3?download=1&signature=example"
        },
        {
          "audio_index": 2,
          "duration": 146.2,
          "audio_url": "https://audio.example/track-2.mp3?signature=example",
          "download_url": "https://audio.example/track-2.mp3?download=1&signature=example"
        }
      ]
    }
  }
}

料金

成功したタスクごとに一度だけ課金されます。確定額は人民元で data.cost_rmb に表示されます。送信時に残高が確保され、失敗時に返還されます。照会やダウンロードに追加料金はかかりません。残高不足の場合は HTTP 402 が返ります。