対応モデル
現在利用できる生成モデル
お客様のリクエストでは、下表のプラットフォームモデル名のみを使用します。モデル名を省略した場合は既定値の suno-v6 が適用されます。
| モデル名 | 表示名 | 用途 | 状態 |
|---|---|---|---|
suno-v6 |
Suno V6 | 通常生成の既定モデル | 利用可能 |
suno-v6-wild |
Suno V6 Wild | V6 Wild バリアント | 利用可能 |
suno-v6-mini |
Suno V6 Mini | V6 Mini バリアント | 利用可能 |
既定の推奨モデルは suno-v6 です。
ステム分離について
ステム分離は独立した固定機能で、楽曲生成モデルを選ぶ必要はありません。ステム API を
呼び出すときは、元の楽曲と分離モード(例:two、twelve)だけを渡します。実際に
返るトラック数はレスポンスの値を基準にしてください。
model パラメータ
生成系 API では model は通常省略可能です。
- 省略した場合は既定の
suno-v6が使われます。 - 指定する場合は
suno-v6、suno-v6-wild、suno-v6-miniのいずれかです。 - 上表のプラットフォームモデル名のみ使用できます。
最小限の生成例
curl -X POST https://www.suno-api.io/api/music/create \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"description": "春の訪れを歌った軽快なフォーク",
"model": "suno-v6"
}'
V6 バリアントの例
{
"model": "suno-v6-wild",
"description": "実験的な構成のエレクトロニック"
}
終了したモデル
次のモデルは新しいリクエストに使用できません。
suno-v2suno-v3suno-v3-5suno-v4suno-v4-5suno-v4-5-allsuno-v4-5-plussuno-v5suno-v5-5
既存の楽曲や過去のタスクには古い model_name や model_version が残っていることが
ありますが、これは履歴データであり、そのモデルで新規リクエストを送れる意味では
ありません。
旧クライアントとの互換のため、終了したモデル名を指定したリクエストは拒否されず、
現在の既定モデル suno-v6 として処理されます。タスク記録にも suno-v6 が残り、
「モデル利用不可」エラーは返りません。ただしリクエスト例は速やかに上表の現行モデル名へ
更新してください。
モデル一覧の取得
GET /v1/models には少なくとも次の通常楽曲モデルが含まれます。
{
"object": "list",
"data": [
{ "id": "suno-v6", "object": "model", "owned_by": "suno" },
{ "id": "suno-v6-wild", "object": "model", "owned_by": "suno" },
{ "id": "suno-v6-mini", "object": "model", "owned_by": "suno" }
]
}
レスポンスには歌詞モデルや互換ルート、内部モデルが含まれることがあります。V6 の楽曲 生成モデルと混同しないでください。
V6 バリアントの選び方
ほとんどの連携では既定モデルだけで十分です。3 つの違いは、プロンプトへの忠実さと 結果のばらつきにあります。
| バリアント | 使う場面 |
|---|---|
suno-v6 |
説明に忠実な予測しやすい結果がほしいとき。既定値で、本番パイプラインに適します。 |
suno-v6-wild |
ばらつきが大きく、複数案を比較してよいとき。スタイル探索に向きます。 |
suno-v6-mini |
本生成の前にプロンプトを低コストで試したいとき。 |
いずれも 1 回で 2 曲返るため、suno-v6-mini で下書きし、気に入ったプロンプトを
suno-v6 で回し直して公開版を選ぶ運用が実用的です。
料金と返金
料金はモデル単位ではなくリクエスト単位です。1 回 0.6 元で 2 曲が返ります。生成に 失敗した場合は自動で返金されるため、失敗した試行が残高を消費することはありません。 ダウンロードは無制限で、別途課金もありません。