Mage API · 音声モデル
MiniMax Music 3 API
歌詞からフルソングを生成、オープンウェイト
POST https://api.mage.space/v1/minimax_music/generateひと目でわかる概要
MiniMax Music 3 APIは、POST https://api.mage.space/v1/minimax_music/generate を通じてMage上でMiniMax Music 3を実行します。デフォルト設定でのリクエストは125 Gems(約$0.125)で、サブスクリプションは不要です。MiniMax Music 3では@handleのメンションは使えません。
- 音声出力
- 1バリアント
- 1251クリップあたりのGems(デフォルト)
- $0.125米ドル換算の目安
概要
MiniMax Music 3 APIでできること
MiniMaxのオープンな楽曲モデル:歌詞を歌うボーカル入りの楽曲、またはインストを最長5分まで生成。ジャンル、声、アレンジの説明で仕上がりを調整できます。LoRAにも対応。
MiniMaxのオープンウェイト楽曲モデル:歌詞どおりに歌うボーカル入りのフルソング、またはインストを最長5分まで、44.1 kHzステレオのMP3で生成します。LoRAにも対応。歌詞は `lyrics` に、サウンドはプロンプトに入力してください。
プロンプトだけで生成します。
クイックスタート
MiniMax Music 3 APIを呼び出す
MAGE_API_KEYを設定し、/minimax_music/generate にリクエストを送信して、完了するまで status_url をポーリングします。
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/minimax_music/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Acoustic pop, 96 BPM, C major, warm and intimate, building into the chorus. Soft female lead, close and breathy, light harmonies in the chorus. Fingerpicked guitar and soft piano; brushed drums and upright bass enter in the chorus.",
"duration": "120",
"lyrics": "[verse]\nMorning light filtering through the pine\nEvery quiet street is yours and mine\n[chorus]\nSoftly the world begins to breathe",
"model_id": "minimax-music-3"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('minimax_music', {
prompt: 'Acoustic pop, 96 BPM, C major, warm and intimate, building into the chorus. Soft female lead, close and breathy, light harmonies in the chorus. Fingerpicked guitar and soft piano; brushed drums and upright bass enter in the chorus.',
duration: '120',
lyrics: '[verse]\nMorning light filtering through the pine\nEvery quiet street is yours and mine\n[chorus]\nSoftly the world begins to breathe',
model_id: 'minimax-music-3',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("minimax_music", {
"prompt": "Acoustic pop, 96 BPM, C major, warm and intimate, building into the chorus. Soft female lead, close and breathy, light harmonies in the chorus. Fingerpicked guitar and soft piano; brushed drums and upright bass enter in the chorus.",
"duration": "120",
"lyrics": "[verse]\nMorning light filtering through the pine\nEvery quiet street is yours and mine\n[chorus]\nSoftly the world begins to breathe",
"model_id": "minimax-music-3",
})
print(request["result"]["url"])モデル
MiniMax Music 3のmodel_id値
model_idを送信してバリアントを選択します。指定しない場合はデフォルトが実行されます。
| model_id | 名前 | デフォルト |
|---|---|---|
| minimax-music-3 | MiniMax Music 3 | はい |
オプション
MiniMax Music 3のパラメーター
全バリアントで使用できる値です。バリアントによっては選択肢が少ない場合があります。バリアントごとのオプションはドキュメントに記載されています。
| フィールド | 値 |
|---|---|
| duration | 30, 60, 120, 180, 240, 300 |
ルール
MiniMax Music 3 APIの制約
- プロンプトでは音楽を説明します(最大4000文字):ジャンル、テンポとキー、雰囲気と盛り上がり方、ボーカリスト(声を指定しないとインストになることがあります)、楽器。
- `lyrics` には歌う歌詞を入れます(最大6000文字)。セクションタグ([intro]、[verse]、[pre-chorus]、[chorus]、[bridge]、[outro])は必ず単独の行に置いてください。タグと同じ行の歌詞は無視されます。
- インストにするには、`lyrics` を空にするか、`instrumental` をtrueに設定します。
- `duration` は曲の最大の長さで、料金にも反映されます。モデルは歌詞とアレンジが終わった時点で曲を終えるため、それより短くなることもよくあります。
その他の音声モデル
Mage のその他の音声生成 API
Seed Audio API
ひとつのプロンプトから音声、音楽、効果音を生成
Eleven Music API
ElevenLabsの楽曲生成。ボーカルありもなしも対応
Eleven Speech API
ElevenLabs v4:演出できるリアルな音声
FAQ
よくある質問
MiniMax Music 3 APIの料金はいくらですか?
MiniMax Music 3 APIのエンドポイントは?
呼び出せるMiniMax Music 3のモデルは?
MiniMax Music 3は参照画像やキャラクターに対応していますか?
MiniMax Music 3をClaudeやChatGPTから使えますか?
MiniMax Music 3の生成結果はどのくらい保存されますか?
Mageで開発を始めよう
アカウントはひとつ、Gemsの残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。