はじめに
SpicyAPI の Suno v6 Mini は、1 回のリクエストで曲の完成版を 2 バージョン返すテキストから音楽を生成するタスクです。Suno は、アイデアを曲にしやすくする、v6 のより高速で効率的なバージョンと説明しています。prompt にスタイルの指示を、必要なら自作の lyrics を送ると、MP3 が 2 つ返ります。ここでの料金は v6、v6 Wild と同じ定額です。
主な機能とハイライト
アイデアを入れると曲が出てくる
一文を書いて lyrics を空にします。generate_lyrics がオン（デフォルト）なら、モデルが歌詞を書いて歌います。当社のテストでは約 3 分半ぶんの歌詞を書き、全行を順番どおりに歌いました。
歌詞の扱いは同じ
自分の言葉を持ち込めば、v6 Mini は書いたとおりに歌います。3 つのモデルすべてに使った 11 行の歌詞シートは、一語ずつ順番どおりに返り、[Verse] と [Chorus] のタグは歌われませんでした。
2 つのテイク
リクエストごとに 2 バージョンが返り、長さが異なることもあります。定額の料金は両方を含むので、手早いドラフトは曲がどれだけ長くなっても同じ料金です。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
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 つのバージョンを含みます。
ユースケース
すばやく曲をスケッチする
ノートとして使いましょう。フックを入力して聴き、書き直します。短い歌詞シートからは約 1 分半の曲ができます。
おだやかな、アコースティックやラウンジ系のスタイル
サンプル用に生成したのは、数点の楽器を指定したフォーク、インディー、ジャズの指示で、フィンガーピッキングのフォークソングから、煙るようなラウンジのインストまでです。
プロンプトガイドと実践のヒント
指示は短く具体的に
ジャンル、bpm で示すテンポ、2、3 個の楽器を書きます。たとえば「acoustic indie folk, 96 bpm, warm male vocal, fingerpicked guitar」のようにします。実在のアーティスト名は拒否されます。
書かせてから、自分で引き継ぐ
まずアイデアから始めて、モデルが選んだ歌詞を読みます。気に入った部分を lyrics にコピーして編集し、もう一度実行すれば、書いたとおりに歌われます。
フィルタが止めるものを知っておく
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-mini/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 リファレンスを参照してください。
