スタイル強化 API
インターフェースの説明
スタイル強化は、短いスタイルタグをより完全で Suno の生成に向いたスタイル記述に展開します。また、完全な歌詞からスタイル記述を生成することもできます。
エンドポイント: POST /api/music/boost-style
課金: 無料枠内は無料（各ユーザーにつき毎分最大 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 が利用できます。
中国語の出力: リクエスト内容（originalTags/lyrics/user_guidance）に中国語が含まれ、言語が明示されていない場合、サービスは original_tags の後に自動で （请用中文描述） を追加し、さらに user_guidance=语言：简体中文；乐器名也用中文 を補います。これにより中国語のスタイル記述が当たりやすくなります。実際に送信された値はレスポンスの appliedOriginalTags、appliedUserGuidance で返ります。送信内容で言語が明記されている場合（例：「簡体字中国語で記述」）、サービスは一切書き換えません。
認証
| パラメータ名 | 型 | 必須 | 説明 |
|---|---|---|---|
| Authorization | string | はい | Bearer YOUR_API_KEY |
| Content-Type | string | はい | application/json |
リクエストパラメータ
| パラメータ名 | 型 | 必須 | 既定値 | 説明 |
|---|---|---|---|---|
| model | string | はい | - | 対客モデル名: suno-v6、suno-v6-wild、suno-v6-mini |
| originalTags | string | いいえ | - | 元のスタイルタグ |
| original_tags | string | いいえ | - | originalTags の互換エイリアス |
| style | string | いいえ | - | 元のスタイルタグ。originalTags との二択 |
| instrumental | boolean | いいえ | false | 純音楽の方向で強化するかどうか |
| lyrics | string | いいえ | - | 完全な歌詞。渡すとその内容からスタイル記述を生成します |
| user_guidance | string | いいえ | - | ユーザーの自然言語による要望（例：「スオナと二胡を加え、男声、テンポを速く」）。プラットフォーム側に同名フィールドがあり、そのまま透過します |
リクエスト例
curl -X POST https://www.suno-api.io/api/music/boost-style \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"originalTags": "pop, piano, male vocal",
"lyrics": "[Verse]\n窓の外に夜が落ちる\n[Chorus]\n私たちは光の方へ歩く",
"user_guidance": "スオナと二胡を加え、男声、テンポを速く",
"instrumental": false
}'
レスポンス結果
{
"code": 200,
"message": "success",
"data": {
"originalTags": "pop, piano, male vocal",
"instrumental": false,
"upsampledStyle": "Mandopop, expressive male vocal, warm piano ballad...",
"requestId": "request_id"
}
}
upsampledStyle は Style 入力欄に書き戻すべき完全なスタイル記述です。