インスピレーション・プロンプト API

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

インターフェースの説明

インスピレーション・プロンプト API は、ランダムな楽曲説明・歌詞テーマ・スタイルタグの提案を返します。「ランダムなひらめき」や「タグを更新」ボタンに向いています。

エンドポイント: POST /api/prompts/suggestions

課金: 無料枠内は無料（各ユーザーにつき毎分最大 10 回、毎日最大 300 回）。無料枠を超えると 1 回 0.1 元。

超過の検知: 無料枠を超えてもリクエストは通常どおり実行され、レスポンスヘッダに X-Suno-Helper-Free: false と X-Suno-Helper-Over-Limit: minute（または day）が付きます。これを使って、今回が従量課金になったことをクライアント側で示せます。

推奨モデル: suno-v6。suno-v6、suno-v6-wild、suno-v6-mini が利用できます。

認証

リクエストパラメータ

リクエスト例

curl -X POST https://www.suno-api.io/api/prompts/suggestions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6"
  }'

レスポンス結果

{
  "code": 200,
  "message": "success",
  "data": {
    "prompts": ["A dreamy synth-pop track about city lights after rain"],
    "lyrics_prompts": ["夜、再会、後悔についての日本語の歌詞を書いて"],
    "tags": ["dreamy synth-pop", "warm piano", "male vocal"],
    "is_pending_personalization": false
  }
}

フィールドの説明