Skip to main content
POST
POST /v1/music/generations/wav は非推奨です。当面は互換性のため利用でき、新 API に formats: ["wav"] を渡す場合と同等です。新規実装では POST /v1/music/generations/download を使用してください。
元の楽曲を選択: 音声を作成したタスクの task_id を渡し、audio_index で結果の music[] から楽曲を選びます。インデックスは 1 始まりで、既定値は 1 です。

認証

string
必須
すべての API で Bearer Token が必要です。API キーページからキーを取得してください。

リクエストパラメータ

string
デフォルト:"suno"
モデル名。suno を使用し、省略時も suno になります。
string
必須
元の楽曲を作成したときに返されたタスク ID。元タスクは現在のアカウントに属し、完了済みで、ダウンロード可能な音声を含む必要があります。楽曲生成、延長、カバー、ステム分離などは利用できますが、歌詞や BPM 解析などのテキストのみのタスクは利用できません。
integer
デフォルト:"1"
元タスクの music[] 結果からダウンロードする楽曲番号。
  • 1 から開始
  • 既定値:1
  • 元タスク内の楽曲数を超える値は不可
string[]
ダウンロードする形式の配列。1 項目以上必要です。対応形式:mp3m4awav複数形式を同時に指定できます。大文字小文字は区別せず、重複は自動削除され、結果はリクエスト順で返ります。
string
1 形式だけの場合、formats の代わりに使用できます。例:"format": "mp3"
formats または format のどちらかを使用してください。両方を省略するか空配列にすると HTTP 400 が返ります。

送信レスポンス

成功するとダウンロードタスク用の新しい task_id が返ります。
data は配列です。data[0].task_id を読み取ってください。この ID は新しいダウンロードタスクのもので、リクエストに渡した元楽曲の task_id とは異なります。

ダウンロード結果の照会

送信レスポンスのダウンロードタスク ID を使用します。
通常は送信時点でファイルが準備済みです。まずすぐに 1 回照会し、completed または failed でなければ 2 秒ごとに最大 60 秒間ポーリングしてください。

完了

ダウンロードには result.files[] を使用します。
result.wavUrl は旧 WAV API との互換性のためだけに存在します。新しいコードは常に result.files[] を使用してください。

処理中

まだ result はありません。ポーリングを続けてください。

失敗

失敗タスクは自動返金され cost: 0 になります。error.message を表示し、再試行を案内してください。

ファイル URL

通常は APIMart のファイルドメインが返ります。保存処理に失敗した場合は上流 CDN の URL が返ることがあり、有効期間は保証されません。
URL を取得したら早めにダウンロードして保存してください。一時 URL を長期保存先として扱わないでください。

エラー

入力検証エラーはタスク作成・課金前に HTTP 400 を返します。 HTTP 403 かつ model_price_not_configured の場合は suno@download の価格が未設定です。サポートへ連絡してください。

課金と再ダウンロード

  • 複数形式を 1 回で指定した場合、課金も 1 回です
  • 同じ楽曲を再度送信すると、同じ形式でも再課金されます
  • 後から別形式を要求する場合も新しい課金になります
  • 失敗タスクは自動返金されます
返された URL を再利用し、リクエスト中はダウンロードボタンを無効にして重複送信・課金を防いでください。

旧 API からの移行

旧 API は当面利用できますが、新しいコードは /generations/download を使用してください。

Response

integer
レスポンスコード。成功時は 200
array
送信レスポンスのデータ