WAV 生成／取得 API

2026-09-18 更新 · Suno-API チーム

インターフェースの説明

WAV インターフェースは、既存の楽曲のロスレス WAV 音声アドレスを生成または取得するために使います。

エンドポイント: POST /api/music/wav

課金: 無料。本エンドポイントは既存楽曲の WAV アドレスの生成・取得に使うもので、残量は消費しません。

待ち時間とタイムアウト（重要）: 本エンドポイントは同期インターフェースで、レスポンスが返った時点で初めて注文が受理されます。実測では多くのリクエストが 1〜3 秒で返り、約 10% が 30 秒を超え、最長は約 230 秒です。クライアントのタイムアウトは 300 秒以上に設定してください。レスポンスが無いことは未生成を意味せず、タイムアウト直後の再試行は避けてください。 接続が切れた場合は少し後に GET /api/music/songs で確認できます。詳しくは新版 API 概要の「待ち時間とタイムアウト設定」をご覧ください。

リクエストパラメータ

Headers

ボディパラメータ

maxAttempts と intervalSeconds はどちらも JSON の数値で、intervalSeconds の単位は秒でありミリ秒ではありません。通常は既定値のままで問題ありません。これらは本エンドポイントが内部で WAV の準備完了を待つ回数と間隔を制御するだけで、楽曲生成タスク自体の状態は変えません。

リクエスト例

curl -X POST https://www.suno-api.io/api/music/wav \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "audioId": "clip_id",
    "maxAttempts": 24,
    "intervalSeconds": 5
  }'

レスポンス結果

{
  "code": 200,
  "message": "success",
  "data": {
    "audioId": "clip_id",
    "status": "complete",
    "wavUrl": "https://media.code-go.com/assets/example.wav"
  }
}

注意事項

WAV の生成と照会は、サーバーが楽曲レコードに基づいて利用可能なリソースを自動的に選択するため、お客様がアカウント情報を提供する必要はありません。

通常の楽曲と分離トラックは同一の制御されたメディア配信経路を使用します。WAV はまず CN2 がダウンロードしてディスクに保存し、成功レスポンスの data.wavUrl は制御された CDN アドレスのみを返し、Suno や S3 の一時ソースアドレスは返しません。

ready の WAV アセットが既にある場合はそのまま再利用し、Suno への再要求やファイルの再移動は行いません。まだ準備されていない WAV は /api/music/query から Suno/S3 アドレスとして公開されず、本エンドポイントまたは統合ダウンロードエンドポイントを呼び出した後にのみオンデマンドで準備されます。

⚠️ WAV アドレスの有効期限は 7 日です。早めに転送保存してください。 返される data.wavUrl はプラットフォームのオブジェクトストレージが提供し、既定で 7 日後に失効します（ファイルは回収され、古いアドレスは 404 を返します）。有効期間内にご自身のストレージへ WAV を転送保存してください。失効後は本エンドポイントを再度呼び出すと新しい有効なアドレスが得られます。

楽曲リソースが一時的に利用できない場合、インターフェースは 409 を返します。しばらくしてから再試行してください。サーバーは不安定な一時アドレスを返すことはありません。