1 回の REST 呼び出しで使う MiniMax Music 2.5
MiniMax Music API は、プラットフォーム共通のアカウント・API キー・非同期タスクモデルを通じて MiniMax Music 2.5 を提供します。生成したいトラックを説明するプロンプトと歌詞（MiniMax Music 2.5 では必須、10〜3000 文字）を送信すると、エンドポイントはすぐに task_id を返します。
結果は専用の MiniMax feed エンドポイントから届きます。task_id を使って GET /v2/minimax/feed?workId=... をポーリングし、ステータスが SUCCESS または FAILED になるまで待つか、callback_url を渡してプラットフォームから最終結果を webhook に POST させます。完了したタスクは生成された音声 URL を response フィールドで返します。
クイックスタート：生成して feed を確認
/v2/minimax/generate に POST し、返された task_id を保持して、曲ができるまで MiniMax feed をクエリします。
curl -X POST "https://udioapi.pro/api/v2/minimax/generate" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Cinematic orchestral pop, emotional female vocal, warm piano",
"lyrics": "Verse 1: The city lights are fading\nChorus: We rise into the morning glow"
}'
curl -X GET "https://udioapi.pro/api/v2/minimax/feed?workId=YOUR_TASK_ID"5〜10 秒ごとに上限時間を設けてポーリングしてください。オプションの bitrate と sample_rate で出力エンコーディングを制御できます。
MiniMax Music 2.5 リクエストパラメータ
generate エンドポイントはコンパクトなパラメータ一式を受け付けます。1 リクエスト 30 クレジット（1 USD = 100 クレジットで約 $0.30）です。
| パラメータ | 型 | 必須 | 備考 |
|---|---|---|---|
| prompt | string | 必須 | トラックを説明 — ジャンル、雰囲気、楽器編成 |
| lyrics | string | 必須 | 10〜3000 文字。MiniMax Music 2.5 では必須 |
| bitrate | number | 任意 | 音声ビットレート（例：256000） |
| sample_rate | number | 任意 | 音声サンプルレート（例：44100） |
| callback_url | string | 任意 | 最終結果を受け取る公開 HTTPS webhook |
| public | boolean | 任意 | タスクを公開するかどうか |
レスポンスは data.task_id とステータス IN_PROGRESS を返します。/v2/minimax/feed?workId=<task_id> をクエリして、ステータスが SUCCESS（response に音声 URL）または FAILED になるまで待ちます。
構築できるもの
MiniMax タスクは音声 API の他の部分と共存します。
歌詞どおりの楽曲
完全な歌詞（10〜3000 文字必須）とスタイルプロンプトで、確定的なボーカルコンテンツを得られます。
ドキュメントを読むボーカルまたはインスト曲
プロンプトでジャンル・雰囲気・アレンジを操り、作曲はモデルに任せます。
ドキュメントを読む複数エンジンを 1 キーで
別のサウンドが必要なとき、同じ API キーで /v2/generate の chirp-v6 ファミリーも呼べます。
ドキュメントを読む生成済みソングの延長
ソースタスク完了後、extend エンドポイントで対象トラックを継続できます。
ドキュメントを読むWAV 変換
生成音声を WAV に変換し、プロダクションパイプラインへ渡します。
ドキュメントを読むコールバックとステータス
MiniMax feed をポーリングするか、callback_url でインフラへ結果を配送します。
ドキュメントを読む使い方
API キーから再生可能なトラックまで、4 ステップ。
- 1
API キーを作成
サインインしてダッシュボードでキーをコピー。サーバーサイドのシークレットに保管し、ブラウザコードには絶対に入れないでください。
- 2
プロンプトと歌詞を送信
prompt、lyrics と任意のエンコーディング項目を /v2/minimax/generate に POST。data.task_id を保存します。
- 3
MiniMax feed をポーリング
5〜10 秒ごとに GET /v2/minimax/feed?workId=<task_id> を呼ぶか、callback_url で webhook を受け取ります。
- 4
音声をダウンロード
SUCCESS になると response フィールドに音声 URL が入ります。自分のストレージに保存してください。
制限と注意点
- 生成は非同期です。POST は音声ではなく task_id を返します。
- MiniMax Music 2.5 では lyrics が必須で、10〜3000 文字である必要があります。
- /v2/minimax/feed を 5〜10 秒ごとに上限付きでポーリングするか、callback_url を使います。
- 音声 URL は一時的です。結果は自分のストレージにダウンロードしてください。
- MiniMax は追加エンジンです。デフォルトの音楽生成エンドポイントは /v2/generate のままです。
udioapi.pro は独立したサードパーティサービスです。Suno、Udio、MiniMax とは提携しておらず、これらによる承認・運営も受けていません。
MiniMax Music API よくある質問
パラメータ・課金・非同期ワークフローへの回答。
これは MiniMax 公式 API ですか？
いいえ。udioapi.pro は独自のエンドポイント・アカウント・クレジット・利用規約・サポートを持つ独立したサードパーティ API サービスです。MiniMax、Suno、Udio と提携しておらず、承認・運営も受けていません。
MiniMax Music 2.5 のリクエスト料金は？
/v2/minimax/generate への 1 リクエストは 30 クレジット（1 USD = 100 クレジットで約 $0.30）です。
歌詞は必須ですか？
はい。MiniMax Music 2.5 では 10〜3000 文字の lyrics フィールドが必須です。歌詞がない、または無効なリクエストは 400 レスポンスで拒否されます。
結果はどう受け取りますか？
generate レスポンスが data.task_id を返します。5〜10 秒ごとに GET /v2/minimax/feed?workId=<task_id> を SUCCESS までポーリングするか、callback_url で webhook を受け取ります。音声 URL は response フィールドに現れます。
どんなステータスが表示されますか？
タスクは IN_PROGRESS で始まり、SUCCESS または FAILED で終わります。失敗したタスクは feed で error_message を報告し、拒否されたリクエストは完了タスクとして課金されません。
下書き用の安いモデルはありますか？
はい。/v2/generate の chirp-v6 ファミリーには 1 リクエスト 10 クレジットの chirp-v6-mini があり、プロトタイピング向けの高速経済ティアです。