はじめに
SpicyAPI の Suno v6 Wild は、1 回のリクエストで曲の完成版を 2 バージョン返すテキストから音楽を生成するタスクです。Suno は v6 Wild を、探究のために作られ、より予測しにくく多彩で、意外性があり質感豊かで野心的な結果を目指すモデルと説明しています。prompt にスタイルの指示を、必要なら自作の lyrics を送ると、MP3 が 2 つ、定額の料金で返ります。
主な機能とハイライト
さまよう（Wander）ために作られた
v6 が磨き込みを狙うのに対し、Wild は冒険を前提にしています。prompt で変わった質感を頼み、自作の歌詞を使う場合やインストの場合は weirdness を上げましょう。1 回のリクエストで 2 バージョンが届くので、同じ指示をどれだけ違って解釈するかがわかります。
言葉には忠実
Wild は歌詞の扱いが雑ではありません。整った 11 行の歌詞シートが、ほかの v6 モデルと同じく、セクションタグを歌わずに、順番どおり一語ずつ歌われました。
歌詞あり、自動作成、歌詞なし
lyrics を送る、prompt からモデルに書かせる（generate_lyrics はデフォルトでオン）、instrumental をオンにする、のいずれかです。長さは歌詞に応じて変わり、サンプルは 0:46 から 3:05 でした。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | スタイルの指示です。自作の歌詞を使う場合やインストの場合は、ジャンル、テンポ、楽器、声、ムードといったスタイルだけを最大 1,000 文字で書きます。 1 文字以上 · 3000 文字以内 |
lyrics | いいえ | 歌わせる言葉で、最大 5,000 文字、1 行ずつ改行して書きます。[Verse]、[Chorus]、[Bridge]、[Outro] などのセクションタグを単独の行に置くと構成が決まり、タグ自体は歌われません。 1 文字以上 · 5000 文字以内 |
generate_lyrics | いいえ | デフォルトはオンです。lyrics が空で instrumental がオフのとき、モデルが prompt から歌詞を書きます。 デフォルト値: |
instrumental | いいえ | オンにするとボーカルのないトラックになります。このとき prompt はスタイルの指示（最大 1,000 文字）になり、lyrics は不要です。 デフォルト値: |
title | いいえ | 曲のタイトルで、最大 80 文字です。自作の歌詞を使う場合か instrumental がオンの場合に有効で、歌詞を自動生成する場合はモデルがタイトルを付けます。 1 文字以上 · 80 文字以内 |
negative_prompt | いいえ | 曲に入れたくないスタイル、音、ムードを、短いカンマ区切りのリストで指定します。例：「harsh distortion, spoken word」。 1 文字以上 · 500 文字以内 |
vocal_gender | いいえ | リードボーカルを女性（female）または男性（male）に寄せます。保証ではなく希望で、どのくらいの割合で守られるかは検証していません。 |
style_weight | いいえ | 曲がスタイル指示にどこまで忠実に従うかを、0 から 1 まで 0.01 刻みで指定します。自作の歌詞を使う場合か instrumental がオンの場合にのみ有効で、それ以外ではわかりやすいエラーが返ります。 |
weirdness | いいえ | 曲が期待される方向からどこまで外れてよいかを、0（定番）から 1（冒険的）まで 0.01 刻みで指定します。自作の歌詞を使う場合か instrumental がオンの場合にのみ有効です。 |
audio_weight | いいえ | 入力した音声が結果にどのくらい強く影響するかを、0 から 1 まで 0.01 刻みで指定します。Suno はボーカルのない曲では対応していません。 |
variety | いいえ | モデルがスタイルの指示をどれだけ変化させるかを、0（オフ：スタイルタグを書いたとおりに使う）から 4（最大）の整数で指定します。デフォルトは 1 です。 |
persona_id | いいえ | 曲を歌う、または演奏する、保存済みの Suno ペルソナ（ボイス）の ID です。任意です。 1 文字以上 · 200 文字以内 |
persona_model | いいえ |
|
image_urls | いいえ | 曲の雰囲気の手がかりになるムード画像を最大 5 枚まで指定できます（JPEG、PNG、WebP、BMP、各 10 MB まで）。歌詞を自動生成するモードでのみ使えます（lyrics なし、instrumental オフ、 |
reference_video_urls | いいえ | 曲の軸にする参考動画を 1 本指定できます（MP4、MOV、WebM、100 MB かつ 241 秒まで）。たとえば動画に音楽を付けたいときに使います。 1 件以内 |
reference_audio_urls | いいえ | 曲のインスピレーションになる参考音声を 1 ファイル指定できます（6 秒から 30 分、500 MB まで）。歌詞を自動生成するモードでのみ使えます（lyrics なし、instrumental オフ、 |
料金
$0.072 / リクエスト
料金は 1 リクエストごとの定額で、曲の長さにかかわらず 2 つのバージョンを含みます。
ユースケース
方向性を試す
同じアイデアを 3 通りのスタイル指示で実行すれば、反応できるテイクが 6 つ手に入ります。トレーラー、ゲームのステージ、ブランドフィルムのサウンドを探す手軽な方法です。
質感のあるBGM
配信、動画、ゲームのメニュー画面向けの、ローファイなベッド、グリッチ風のポップス、質感豊かなアンビエントのトラックです。
プロンプトガイドと実践のヒント
質感を具体的に
Wild は細かな描写に応えてくれます。「pop」の代わりに、「experimental synth-pop, 108 bpm, airy female vocal, detuned analog synths, bowed glass textures」と書いてみましょう。実在のアーティスト名は避けてください。そうしたプロンプトは拒否されます。
weirdness と variety を併用する
自作の歌詞を使う場合かインストの場合、weirdness は曲を期待される方向から遠ざけ、variety はモデルがスタイルの指示をどれだけ作り替えるかを決めます（0 ならスタイルタグを書いたとおりに使います）。それぞれの効果を聴き分けるために、一度に 1 つずつ変えてください。
フィルタが止めるものを知っておく
Suno は最も強い歌詞と説明を数秒で退け、課金はしません。軽めの歌詞、ささやくような歌い方、強めの言葉は歌われました。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "suno/v6-wild/text-to-audio",
"input": {
"prompt": "Calm ambient pads with a slow rising motif"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。
