MiniMax: Music 2.5
MiniMax Music 2.5透過同步音樂請求，將歌詞與音樂需求轉換為生成音訊。此確切版本允許空的prompt，接受1至3,500個字元的lyrics，並提供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個字元的lyrics，並提供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 費率
各設定的價格
請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。
| 設定 | 費率表 | 計費數量 | 費用 |
|---|---|---|---|
| 設定基礎 token 費率 | 費率表基本費率 | 計費數量— | 費用 輸入 · 輸入 Token — / 1K Token 輸出 · 輸出 Token — / 1K Token 輸入 · 讀取快取 — / 1K Token 輸入 · 寫入快取 — / 1K Token 輸入 · 寫入快取，1 小時 — / 1K Token |
| 設定每次請求 | 費率表— | 計費數量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
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 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個字元的lyrics，並提供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 費率
各設定的價格
請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。
| 設定 | 費率表 | 計費數量 | 費用 |
|---|---|---|---|
| 設定基礎 token 費率 | 費率表基本費率 | 計費數量— | 費用 輸入 · 輸入 Token — / 1K Token 輸出 · 輸出 Token — / 1K Token 輸入 · 讀取快取 — / 1K Token 輸入 · 寫入快取 — / 1K Token 輸入 · 寫入快取，1 小時 — / 1K Token |
| 設定每次請求 | 費率表— | 計費數量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
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 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