はじめに
SpicyAPI の MiniMax Music 3.0 は、1 回のリクエストで完成した楽曲を 1 曲返すテキストから音楽を生成するタスクです。リードボーカル、バッキングのアレンジ、最終ミックスが、1 本のステレオ MP3 にまとまって返ってきます。prompt にスタイルの指定を、歌わせたい言葉があれば lyrics に書いて送ると、メロディ、アレンジ、歌唱はモデルが担当します。当社のテストでは曲の長さは 1:09 から 3:58 で、どの曲でも料金は 1 曲ごとの定額でした。
主な機能とハイライト
ループではなく、一曲まるごと
結果は、短い繰り返しのクリップではなく、イントロ、ヴァース、戻ってくるサビ、エンディングを備えた構成のある曲です。長さはモデルが決め、主に渡した歌詞の量で変わります。ボーカルとバッキングは 1 本のステレオファイルにミックスされ、そのまま再生できます。
歌詞の扱いは 3 通り
自作の歌詞を歌わせる、モデルに歌詞を書かせる、歌い手を外す、の 3 つから選べます。渡した歌詞は書いたとおりに歌われ、[Verse] や [Chorus] といったセクションタグでアレンジを方向づけられます。lyrics を空にすると、generate_lyrics(デフォルトはオン)がプロンプトから歌詞を一式書きます。instrumental をオンにすると、トラックにはボーカルがまったく入りません。
定額の料金と、調整できるファイル音質
曲の長さ、bitrate、sample_rate を変えても、1 曲の料金は変わりません。マスター用には 44.1 kHz で 256 kbps を、プレビュー用の小さなファイルには低めのビットレートを選んでください。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 最大 2,000 文字のスタイル指定です。ジャンル、ムード、テンポ、楽器、声の種類、シーンなどを書きます。 1 文字以上 · 2000 文字以内 |
lyrics | いいえ | 歌わせる言葉で、最大 3,000 文字です。1 行ごとに改行し、間を取りたい箇所は空行にします。 1 文字以上 · 3000 文字以内 |
generate_lyrics | いいえ | デフォルトはオンです。lyrics が空のとき、モデルが prompt から歌詞を書きます。 デフォルト値: |
instrumental | いいえ | オンにするとボーカルのない音楽になり、lyrics は不要です。デフォルトはオフです。 デフォルト値: |
bitrate | いいえ | MP3 のビットレートで、単位は bps です。32000、64000、128000、256000(デフォルト)から選びます。 |
sample_rate | いいえ | サンプルレートで、単位は Hz です。16000、24000、32000、44100(デフォルト)から選びます。 |
料金
$0.18 / 曲
料金は 1 曲ごとの定額で、長さや音質によって変わりません。
ユースケース
自作の歌詞を軸にした楽曲
まず歌詞シートを書き、セクションにタグを付けて、頭の中で鳴っているジャンルと声を言葉にします。パーソナライズした曲、物語やゲームのキャラクターテーマ、パロディ曲、先に歌で聴いてみたい歌詞のラフなデモに向いています。
動画や配信のための音楽
アンダースコア、ラウンジ系のBGM、イントロ曲には instrumental をオンにし、タイトル曲にはボーカルを残します。1 分から 4 分のトラックなら、たいていの短い動画は 1 回のリクエストでまかなえます。料金は定額なので、何テイクか生成して最良のものを選ぶのも気軽です。
プロンプトガイドと実践のヒント
スタイルと言葉を分ける
prompt にはサウンドだけを書きます。ジャンル、bpm で示すテンポ、2、3 個の楽器、声の種類とムードです。例:「dreamy synth-pop, 100 bpm, airy female lead vocal, shimmering pads, late-night city mood」。歌わせたい言葉はすべて lyrics に入れてください。歌詞にスタイルの言葉が混ざっていると、そのまま歌われがちです。
セクションタグで曲を組み立てる
歌詞は 1 行を 1 段に書き、[Intro]、[Verse]、[Pre Chorus]、[Chorus]、[Bridge]、[Outro] などのタグは単独の行に置きます。サビを戻したい位置には、同じサビの歌詞をもう一度書きます。ヴァースとサビで約 1 分半の曲になるので、長くしたいときはヴァースとブリッジを足してください。
フィルタが止めるものを知っておく
MiniMax はプロンプトと歌詞をチェックします。強い言葉は書いたとおりに歌われますが、それを超える歌詞は拒否され、課金もされません。その部分は穏やかな表現にとどめてください。
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": "minimax/music-3.0/text-to-audio",
"input": {
"prompt": "Calm ambient pads with a slow rising motif",
"bitrate": 256000,
"sample_rate": 44100
}
}'
# 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 リファレンスを参照してください。















