Suno 音楽生成 API
Suno V6 で説明文や自作の歌詞から楽曲を生成できます。歌声なしのインストゥルメンタルにも対応しています。
ベース URL は https://api.icodeeasy.cc です。接続が遅い場合は、同じパスのまま https://jp.icodeeasy.cc または https://sg.icodeeasy.cc に切り替えてください。送信と照会には Authorization: Bearer <API キー> が必要です。
生成タスクを送信する
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 を保存してください。生成が完了すると楽曲を取得できます。
{"code":202,"data":[{"task_id":"mus_0123456789abcdef0123456789abcdef","status":"submitted","progress":0}]}
リクエストパラメーター
| フィールド | 用途 |
|---|---|
model | suno を指定します。省略できます。 |
version | v6(既定)、v6-wild、または v6-mini。 |
custom | false(既定)で説明文から生成し、true で自作の歌詞を使います。 |
prompt | 説明文は最大 3,000 文字、自作の歌詞は最大 5,000 文字です。custom と instrumental が両方とも true の場合は省略できます。 |
instrumental | true でインストゥルメンタルを生成します。 |
title / style | カスタムモードで省略可能な曲名とスタイルです。それぞれ最大 80 文字、1,000 文字です。 |
audio_format | mp3(既定)、m4a、または wav。 |
新しいタスクごとに、128 バイト以内の一意の Idempotency-Key を指定してください。送信がタイムアウトしたり応答を受信できなかったりした場合は、同じリクエスト本文とキーで再送すると既存のタスクを取得できます。異なる内容でキーを再利用すると HTTP 409 が返ります。
タスクを確認して楽曲をダウンロードする
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 キーなしで使用できるため、他人と共有しないでください。有効期限が切れたら、タスクを再照会してリンクを取得してください。
完了時のレスポンス例です。金額はフィールドの形式を示すための例です。
{
"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 が返ります。