歌詞生成 API
インターフェースの説明
歌詞生成は、テーマ・既存歌詞の文脈・スタイル要件から歌詞を生成または書き換えます。現在のエンドポイントは最新の歌詞生成契約にアップグレード済みで、プロフェッショナルモードの生成にそのまま使えます。
エンドポイント: POST /api/lyrics/generate
課金: 無料枠内は無料（1 ユーザーあたり毎分最大 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 が利用できます。
認証
| パラメータ名 | 型 | 必須 | 説明 |
|---|---|---|---|
| Authorization | string | はい | Bearer YOUR_API_KEY |
| Content-Type | string | はい | application/json |
リクエストパラメータ
| パラメータ名 | 型 | 必須 | 既定値 | 説明 |
|---|---|---|---|---|
| model | string | はい | - | 対客モデル名: suno-v6、suno-v6-wild、suno-v6-mini |
| instruction | string | はい | - | 歌詞のテーマまたは生成要件 |
| style | string | いいえ | - | スタイル要件 |
| title | string | いいえ | - | 曲名またはタイトルの制約 |
| selected | string | いいえ | "" |
書き換え対象として選ばれたテキスト |
| context_before | string | いいえ | "" |
前の文脈 |
| context_after | string | いいえ | "" |
後の文脈 |
| mode | string | いいえ | apply_user_request |
歌詞生成モード |
| references | array | いいえ | [] |
参考素材のリスト |
| num_variants | integer | いいえ | null |
希望する歌詞バリエーション数 |
| lyricist_id | string | いいえ | null |
作詞者 ID の指定（作詞者リストは終了済みのため、新規接続は非推奨） |
| metadata | object | いいえ | - | 拡張パラメータ。lyrics_model、enable_thinking に対応 |
| lyrics_project_id | string | いいえ | null |
既存の歌詞プロジェクト ID（歌詞プロジェクト系列は終了済みのため、新規接続は非推奨） |
instruction は旧フィールド theme と prompt も受け付けます。metadata.lyrics_model の既定は default、metadata.enable_thinking の既定は false です。
言語の制御
現在のエンドポイントに独立した language リクエストフィールドはありません。歌詞の言語は instruction の内容で決まり、style は補助的な役割しか持ちません。
中国語の歌詞を生成するには、instruction で目標言語を明示してください。例:
{
"model": "suno-v6",
"instruction": "请用中文写歌词，主题是夏夜海边重逢",
"style": "Mandopop, 中文流行"
}
"Write the lyrics in Chinese about ..." と書いても構いません。英語の歌詞を生成する場合は "请用英文写歌词" または "Write the lyrics in English" と書きます。英語のテーマだけを渡して目標言語を書かない場合、結果は英語になることがあります。
リクエスト例
curl -X POST https://www.suno-api.io/api/lyrics/generate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"instruction": "卒業シーズンと再出発についての日本語の歌詞",
"style": "ポップロック、真摯、サビに記憶点",
"title": "再出発",
"metadata": {
"lyrics_model": "default",
"enable_thinking": false
}
}'
レスポンス結果
{
"code": 200,
"message": "success",
"data": {
"lyrics": "[Verse]\n風がグラウンドを吹き抜ける\n私たちは昨日に手を振る",
"edited_lyrics": "[Verse]\n風がグラウンドを吹き抜ける\n私たちは昨日に手を振る",
"lyrics_id": "lyrics_id",
"lyrics_request_id": "lyrics_request_id"
}
}
edited_lyrics は歌詞入力欄に書き入れるべき完全な歌詞です。lyrics_id と lyrics_request_id は追跡用で、エンドポイントの返却状況によっては空になることがあります。曲 ID として扱わないでください。
互換性の説明
- 旧フィールド
theme、promptも使用でき、instructionにマッピングされます。 - 「歌詞プロジェクト / 作詞者」系列のエンドポイントは終了しました。生成結果を残したい場合は、エンドポイントが返す
edited_lyricsをご自身で保存してください。