メインコンテンツへスキップ

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-3MiniMax Music 3はい

オプション

MiniMax Music 3のパラメーター

全バリアントで使用できる値です。バリアントによっては選択肢が少ない場合があります。バリアントごとのオプションはドキュメントに記載されています。

フィールド値
duration30, 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

  • 音声 · 19 Gems から

    Seed Audio API

    ひとつのプロンプトから音声、音楽、効果音を生成

  • オーディオ · 113 Gems から

    Eleven Music API

    ElevenLabsの楽曲生成。ボーカルありもなしも対応

  • 音声 · 30 Gemsから

    Eleven Speech API

    ElevenLabs v4:演出できるリアルな音声

FAQ

よくある質問

MiniMax Music 3 APIの料金はいくらですか?
デフォルト設定(MiniMax Music 3)でのMiniMax Music 3リクエストは125 Gems、約$0.125です。解像度、長さ、バリエーションを変えると料金も変わり、正確な請求額はレスポンスに含まれます。生成に失敗した場合は返金されますが、Mageのコンテンツポリシーによってブロックされた場合は返金されません。
MiniMax Music 3 APIのエンドポイントは?
POST https://api.mage.space/v1/minimax_music/generate に、MageのAPIキーを入れた Authorization: Bearer ヘッダーを付けて送信します。レスポンスには、結果をポーリングするための status_url が含まれます。
呼び出せるMiniMax Music 3のモデルは?
minimax-music-3(MiniMax Music 3)です。デフォルトはMiniMax Music 3です。
MiniMax Music 3は参照画像やキャラクターに対応していますか?
MiniMax Music 3は、画像・動画・音声の入力に対応していません。@handleのメンションも使えません。
MiniMax Music 3をClaudeやChatGPTから使えますか?
はい。Mage MCPサーバーをClaude、ChatGPT、Claude Code、Grok、Cursorに接続し、MiniMax Music 3を名前で指定してください。アシスタントが get_model でオプションを読み取り、生成前に料金を伝えます。
MiniMax Music 3の生成結果はどのくらい保存されますか?
生成結果と入力データは30日間保存されます。残したいものは自分のストレージにダウンロードしてください。

Mageで開発を始めよう

アカウントはひとつ、Gemsの残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。

Charactersコミュニティ