MiniMax: Music 2.5
MiniMax Music 2.5は、歌詞と音楽の制作指示から、同期の音楽リクエストで音声を生成します。この正確な版では空のpromptが許可され、1～3,500文字の歌詞を受け付け、MP3またはWAVで出力します。
- Ailoot Ultra · Music
POST /v1/music/generationsminimax/music-2.5 - Ailoot Ultra · Music
POST /v1/music/generationsmusic-2.5
モデルについて
この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。
MiniMax Music 2.5は、文章で記述した音楽の制作指示と歌詞から音楽を作成します。この正確な版にはminimax/music-2.5を選びます。設定されたエイリアスはmusic-2.5です。音楽メソッドはmodel、prompt、lyricsを含むJSONリクエストを使用し、音声を生成します。文章で記述した楽曲コンセプトを試聴用の下書きにしたり、渡した歌詞に曲を付けたり、追加編集の前に構成を検討したりするために使います。
promptには音楽のスタイル、雰囲気、舞台を記述し、lyricsには歌う言葉を入れます。有用な指示なら、静かなカフェ向けの内省的なフォークソングを求め、情景を描くヴァースと中心的な考えを繰り返すコーラスを指定できます。音楽の方向性はprompt、意図する歌詞はlyricsに置き、テキストが曲の中で明確な役割を持つようにしてください。
この版では、promptは0から2,000文字、lyricsは1から3,500文字が許可されます。スキーマではpromptが依然として必須フィールドに挙げられているため、設定されたリクエストには値が空でもpromptフィールドを含めます。方向性を指定して作曲する場合は、このフィールドにジャンル、感情、舞台を記述します。空の値では、これらの文章による方向付けは指定されません。歌詞全体は、歌詞用の上限内に収めてください。
歌詞の各行は改行文字で分けます。[Intro]、[Verse]、[Pre Chorus]、[Chorus]、[Bridge]、[Outro]などのセクションラベルで意図する構成を示せます。文書上の一覧には[Interlude]、[Post Chorus]、[Transition]、[Break]、[Hook]、[Build Up]、[Inst]、[Solo]も含まれます。実際の歌詞をセクションラベルの下に置き、セクションの繰り返しは意図的に設定してください。これらの目印は作曲の構成の土台になります。完成した曲が、移行と繰り返しを実際にどう表現しているかを確認します。
audio_settingオブジェクトでは、sample_rateに16000、24000、32000、44100、bitrateに32000、64000、128000、256000、formatにmp3またはwavを指定できます。次の編集や再生の手順に合わせてファイル設定を選び、制作指示とともに保持します。公開例では44100、256000、mp3を要求しています。これらは例での選択であり、各フィールドで常に使われる既定値ではありません。
選択された音楽ワークフローは同期で、ストリーミングを使用しません。文書に記載されたoutput_formatはurlとhexで、スキーマの既定値はhexです。選択された例ではurlを明示的に要求しています。URL出力では、返されたAilootリンクから保存済みの音声をダウンロードします。hexの結果は音声バイトを表し、再生前に選択したファイル形式へデコードする必要があります。応答では、単一の生成音声についてaudioとaudio_urlの両方が返されることがあります。その結果は一曲として保持してください。
完成した音声は、歌詞、音楽の制作指示、正確なモデルID、要求したファイル設定と一緒に保存します。プロジェクトに組み込む前に、意図する言葉、セクションの順序、音楽の方向性を聴いて確認してください。完全な結果が得られずリクエストが終了した場合は、結果確認のために元のリクエスト識別情報と応答情報を保持します。自動で代替リクエストを送ると、別の曲が作成される可能性があります。修正では、比較のために指示のほかの部分を維持しながら、特定の歌詞や音楽上の指示を変更できます。
Ailoot Ultra · Music POST /v1/music/generations minimax/music-2.5
minimax/music-2.5minimax/music-2.5music-2.5
はじめに
MiniMax Music 2.5は、歌詞と音楽の制作指示から、同期の音楽リクエストで音声を生成します。この正確な版では空のpromptが許可され、1～3,500文字の歌詞を受け付け、MP3またはWAVで出力します。
- 対応する入力
- テキスト
- 結果
- 音声
Ailootで利用可能 · 入力とメソッド
Ailoot Ultra · Music POST /v1/music/generations
- 入力の種類
text- 出力の種類
audio- 出力形式
- mp3,wav
| フィールド | 種類 | 要件 | 値と制限 | デフォルト |
|---|---|---|---|---|
フィールドmodel | 種類string | 要件必須 | 値と制限 minimax/music-2.5 | デフォルト— |
フィールドprompt | 種類string | 要件必須 | 値と制限 | デフォルト— |
フィールドlyrics | 種類string | 要件必須 | 値と制限 | デフォルト— |
フィールドstream | 種類boolean | 要件任意 | 値と制限 false | デフォルトfalse |
フィールドoutput_format | 種類string | 要件任意 | 値と制限 url, hex | デフォルトhex |
フィールドaudio_setting | 種類object | 要件任意 | 値と制限 | デフォルト— |
フィールドaudio_setting.sample_rate | 種類integer | 要件任意 | 値と制限 16,000, 24,000, 32,000, 44,100 | デフォルト— |
フィールドaudio_setting.bitrate | 種類integer | 要件任意 | 値と制限 32,000, 64,000, 128,000, 256,000 | デフォルト— |
フィールドaudio_setting.format | 種類string | 要件任意 | 値と制限 mp3, wav | デフォルト— |
フィールドaigc_watermark | 種類boolean | 要件任意 | 値と制限 | デフォルトfalse |
メソッドのパラメータとライフサイクル
| パラメータ | 仕様 |
|---|---|
パラメータcontent_type | 仕様application/json |
パラメータrequired | 仕様model, prompt, lyrics |
パラメータoptional | 仕様stream, output_format, audio_setting, aigc_watermark |
パラメータmaterial_types | 仕様text |
パラメータconditions | 仕様Use a nonstreaming request. MP3 and WAV are available; a PCM control is absent from this method. |
ライフサイクル: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
料金
料金情報はリクエストの機能を追加しません。対応するパラメーターは選択したメソッドに記載されています。
- 高速モード
- 未指定 高速モードが選択されている場合
- Flex モード
- 未指定 flex モードが選択されている場合
- 最大推論量
- 未指定 推論量が最大で、調整に既定値（default）を使用する場合
Ailootの料金
設定別の価格
各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。
| 設定 | 料金表 | 課金数量 | 料金 |
|---|---|---|---|
| 設定基本トークン料金 | 料金表基本料金 | 課金数量— | 料金 入力 · 入力トークン — / 1K トークン 出力 · 出力トークン — / 1K トークン 入力 · キャッシュ読み取り — / 1K トークン 入力 · キャッシュ書き込み — / 1K トークン 入力 · キャッシュ書き込み、1時間 — / 1K トークン |
| 設定リクエストごと | 料金表— | 課金数量リクエスト1件 | 料金 入力 $0.3 リクエストあたり |
Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。金額の確保と精算の仕組み →
リクエスト例
Ailoot Ultra · Music
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "minimax/music-2.5", "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆", "lyrics": "[verse]\\n街灯微亮晚风轻抚\\n影子拉长独自漫步\\n旧外套裹着深深忧郁\\n不知去向渴望何处\\n[chorus]\\n推开木门香气弥漫\\n熟悉的角落陌生人看", "audio_setting": {"sample_rate": 44100, "bitrate": 256000, "format": "mp3"}, "output_format": "url"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
結果を受け取って保存
Ailoot Ultra · Music
mp3,wav
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
完了した結果をすべて保存
返された完全なレスポンス、ファイル、コンテンツ部分をすべて保存してください。
One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.
元のレスポンスを確認する場合
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
レスポンスのフィールド
| フィールド | 種類 |
|---|---|
フィールドdata.audio | 種類string |
フィールドdata.audio_url | 種類string |
フィールドdata.status | 種類integer |
エイリアス
モデルのエイリアス
Ailoot Ultra minimax/music-2.5, music-2.5
メソッドパスのエイリアス
上記に表示されたメソッドパスを使用してください。
関連する呼び出し用ID
Ailoot Ultra · Music POST /v1/music/generations music-2.5
music-2.5minimax/music-2.5music-2.5
はじめに
MiniMax Music 2.5は、歌詞と音楽の制作指示から、同期の音楽リクエストで音声を生成します。この正確な版では空のpromptが許可され、1～3,500文字の歌詞を受け付け、MP3またはWAVで出力します。
- 対応する入力
- テキスト
- 結果
- 音声
Ailootで利用可能 · 入力とメソッド
Ailoot Ultra · Music POST /v1/music/generations
- 入力の種類
text- 出力の種類
audio- 出力形式
- mp3,wav
| フィールド | 種類 | 要件 | 値と制限 | デフォルト |
|---|---|---|---|---|
フィールドmodel | 種類string | 要件必須 | 値と制限 music-2.5 | デフォルト— |
フィールドprompt | 種類string | 要件必須 | 値と制限 | デフォルト— |
フィールドlyrics | 種類string | 要件必須 | 値と制限 | デフォルト— |
フィールドstream | 種類boolean | 要件任意 | 値と制限 false | デフォルトfalse |
フィールドoutput_format | 種類string | 要件任意 | 値と制限 url, hex | デフォルトhex |
フィールドaudio_setting | 種類object | 要件任意 | 値と制限 | デフォルト— |
フィールドaudio_setting.sample_rate | 種類integer | 要件任意 | 値と制限 16,000, 24,000, 32,000, 44,100 | デフォルト— |
フィールドaudio_setting.bitrate | 種類integer | 要件任意 | 値と制限 32,000, 64,000, 128,000, 256,000 | デフォルト— |
フィールドaudio_setting.format | 種類string | 要件任意 | 値と制限 mp3, wav | デフォルト— |
フィールドaigc_watermark | 種類boolean | 要件任意 | 値と制限 | デフォルトfalse |
メソッドのパラメータとライフサイクル
| パラメータ | 仕様 |
|---|---|
パラメータcontent_type | 仕様application/json |
パラメータrequired | 仕様model, prompt, lyrics |
パラメータoptional | 仕様stream, output_format, audio_setting, aigc_watermark |
パラメータmaterial_types | 仕様text |
パラメータconditions | 仕様Use a nonstreaming request. MP3 and WAV are available; a PCM control is absent from this method. |
ライフサイクル: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
料金
料金情報はリクエストの機能を追加しません。対応するパラメーターは選択したメソッドに記載されています。
- 高速モード
- 未指定 高速モードが選択されている場合
- Flex モード
- 未指定 flex モードが選択されている場合
- 最大推論量
- 未指定 推論量が最大で、調整に既定値（default）を使用する場合
Ailootの料金
設定別の価格
各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。
| 設定 | 料金表 | 課金数量 | 料金 |
|---|---|---|---|
| 設定基本トークン料金 | 料金表基本料金 | 課金数量— | 料金 入力 · 入力トークン — / 1K トークン 出力 · 出力トークン — / 1K トークン 入力 · キャッシュ読み取り — / 1K トークン 入力 · キャッシュ書き込み — / 1K トークン 入力 · キャッシュ書き込み、1時間 — / 1K トークン |
| 設定リクエストごと | 料金表— | 課金数量リクエスト1件 | 料金 入力 $0.3 リクエストあたり |
Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。金額の確保と精算の仕組み →
リクエスト例
Ailoot Ultra · Music
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "music-2.5", "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆", "lyrics": "[verse]\\n街灯微亮晚风轻抚\\n影子拉长独自漫步\\n旧外套裹着深深忧郁\\n不知去向渴望何处\\n[chorus]\\n推开木门香气弥漫\\n熟悉的角落陌生人看", "audio_setting": {"sample_rate": 44100, "bitrate": 256000, "format": "mp3"}, "output_format": "url"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
結果を受け取って保存
Ailoot Ultra · Music
mp3,wav
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
完了した結果をすべて保存
返された完全なレスポンス、ファイル、コンテンツ部分をすべて保存してください。
One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.
元のレスポンスを確認する場合
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
レスポンスのフィールド
| フィールド | 種類 |
|---|---|
フィールドdata.audio | 種類string |
フィールドdata.audio_url | 種類string |
フィールドdata.status | 種類integer |
エイリアス
モデルのエイリアス
Ailoot Ultra minimax/music-2.5, music-2.5
メソッドパスのエイリアス
上記に表示されたメソッドパスを使用してください。
関連する呼び出し用ID
FAQ · MiniMax: Music 2.5
- 利用できる入力と結果は何ですか？
POST /v1/music/generations·minimax/music-2.5:text→audioPOST /v1/music/generations·music-2.5:text→audio- リクエストはどの項目を使用しますか？
POST /v1/music/generations·minimax/music-2.5:model,prompt,lyrics,stream,output_format,audio_setting,aigc_watermarkPOST /v1/music/generations·music-2.5:model,prompt,lyrics,stream,output_format,audio_setting,aigc_watermark