{ "aboutHtml": "

MiniMax Music 2.5+可根據書面音樂需求與歌詞建立音樂。選擇minimax/music-2.5+即可使用此確切版本；music-2.5+是其已設定的別名。其音樂方法使用含有model、prompt與lyrics的JSON請求，並產生音訊。它可將書面歌曲概念轉為試聽草稿、為提供的歌詞譜曲，或在進一步編輯前探索作品。

使用prompt描述音樂風格、情緒與場景，lyrics則提供要演唱的文字。實用需求可以要求一首適合安靜咖啡館的內省民謠，以主歌建立場景，並以副歌重複核心概念。請將音樂方向放在prompt，預期歌詞放在lyrics，讓文字在作品中具有清楚用途。

使用Music 2.5+時，prompt必須包含10至2,000個字元，lyrics必須包含10至3,500個字元。請在請求中同時包含這兩個文字欄位與所選模型。利用prompt篇幅說明重要的音樂選擇，再於lyrics提供完整預期歌詞。相較於將不相關指示分散在兩個欄位，精簡而完整的需求更容易與回傳歌曲比較。

請以換行字元分隔歌詞行。[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與要求的檔案設定一併儲存。放入專案前，請聆聽並檢查預期歌詞、段落順序與音樂方向。若請求結束時沒有完整結果，請保留原始請求識別資訊與回應資訊，以供檢查結果；自動發出替代請求可能建立另一首歌曲。修訂時，可修改特定歌詞或音樂指示，並保留其餘需求以供比較。

", "aboutText": "MiniMax Music 2.5+可根據書面音樂需求與歌詞建立音樂。選擇minimax/music-2.5+即可使用此確切版本；music-2.5+是其已設定的別名。其音樂方法使用含有model、prompt與lyrics的JSON請求，並產生音訊。它可將書面歌曲概念轉為試聽草稿、為提供的歌詞譜曲，或在進一步編輯前探索作品。\n\n使用prompt描述音樂風格、情緒與場景，lyrics則提供要演唱的文字。實用需求可以要求一首適合安靜咖啡館的內省民謠，以主歌建立場景，並以副歌重複核心概念。請將音樂方向放在prompt，預期歌詞放在lyrics，讓文字在作品中具有清楚用途。\n\n使用Music 2.5+時，prompt必須包含10至2,000個字元，lyrics必須包含10至3,500個字元。請在請求中同時包含這兩個文字欄位與所選模型。利用prompt篇幅說明重要的音樂選擇，再於lyrics提供完整預期歌詞。相較於將不相關指示分散在兩個欄位，精簡而完整的需求更容易與回傳歌曲比較。\n\n請以換行字元分隔歌詞行。[Intro]、[Verse]、[Pre Chorus]、[Chorus]、[Bridge]與[Outro]等段落標籤可識別預期結構；文件所列標籤也包含[Interlude]、[Post Chorus]、[Transition]、[Break]、[Hook]、[Build Up]、[Inst]與[Solo]。請將實際歌詞放在對應段落標籤下，並有意識地安排重複段落。這些標記為作品提供依循結構；請檢視完成歌曲實際如何呈現轉場與重複。\n\naudio_setting物件提供sample_rate值16000、24000、32000或44100，bitrate值32000、64000、128000或256000，以及format值mp3或wav。請依下一個編輯或播放步驟選擇檔案設定，並連同需求保留。公開範例請求44100、256000與mp3；這些是範例選擇，並非三個欄位共通的通用預設值。\n\n所選音樂工作流程採同步、非串流方式。文件所列output_format選項為url與hex，結構描述預設值為hex；所選範例則明確請求url。若輸出為URL，請使用回傳的Ailoot連結下載已儲存音訊。hex結果代表音訊位元組，必須先解碼成所選檔案格式才能播放。回應可能同時含有同一段生成音訊的audio與audio_url位置；請將該結果保留為同一首歌曲。\n\n請將完成音訊連同歌詞、音樂需求、確切模型ID與要求的檔案設定一併儲存。放入專案前，請聆聽並檢查預期歌詞、段落順序與音樂方向。若請求結束時沒有完整結果，請保留原始請求識別資訊與回應資訊，以供檢查結果；自動發出替代請求可能建立另一首歌曲。修訂時，可修改特定歌詞或音樂指示，並保留其餘需求以供比較。", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "95c64650cff6a8a8722377f8012bd29926b40a42057427af71e6b4c2827f614c", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "zh-hant-tw", "methods": [ { "html": "
MM

MiniMax: Music 2.5+

MiniMax /minimax/music-2.5+

入門

MiniMax Music 2.5+可根據風格與情緒提示詞及提供的歌詞生成音樂。其同步音樂規格接受10至2,000個字元的prompt、10至3,500個字元的lyrics，並提供MP3或WAV輸出。

接受的輸入
文字
結果
音訊
關於模型

此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。

MiniMax Music 2.5+可根據書面音樂需求與歌詞建立音樂。選擇minimax/music-2.5+即可使用此確切版本；music-2.5+是其已設定的別名。其音樂方法使用含有model、prompt與lyrics的JSON請求，並產生音訊。它可將書面歌曲概念轉為試聽草稿、為提供的歌詞譜曲，或在進一步編輯前探索作品。

使用prompt描述音樂風格、情緒與場景，lyrics則提供要演唱的文字。實用需求可以要求一首適合安靜咖啡館的內省民謠，以主歌建立場景，並以副歌重複核心概念。請將音樂方向放在prompt，預期歌詞放在lyrics，讓文字在作品中具有清楚用途。

使用Music 2.5+時，prompt必須包含10至2,000個字元，lyrics必須包含10至3,500個字元。請在請求中同時包含這兩個文字欄位與所選模型。利用prompt篇幅說明重要的音樂選擇，再於lyrics提供完整預期歌詞。相較於將不相關指示分散在兩個欄位，精簡而完整的需求更容易與回傳歌曲比較。

請以換行字元分隔歌詞行。[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 可用 · 輸入與方法

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\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=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"}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\n# Submit once. Retain the complete result, original identifiers and every response header.\n

接收並儲存結果

Ailoot Ultra · Music

mp3,wav

保留所有已完成的結果

請保留所有完整傳回的回應、檔案與內容區塊。

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

minimax/music-2.5+, music-2.5+

", "method_identity": { "effective_request_model_id": "minimax/music-2.5+", "fmt": "music", "http": "POST", "path": "/v1/music/generations", "request_model_id": "minimax/music-2.5+", "route_label": "Ultra" }, "method_key": "Ultra|music|/v1/music/generations|minimax%2Fmusic-2.5%2B", "ordinal": 0, "rawMethod": { "available": null, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response, all actual results, original identifiers, usage and response headers.", "authentication": { "api_key_source": "AILOOT_API_KEY", "header": "Authorization: Bearer" }, "example_body": { "audio_setting": { "bitrate": 256000, "format": "mp3", "sample_rate": 44100 }, "lyrics": "[verse]\n街灯微亮晚风轻抚\n影子拉长独自漫步\n旧外套裹着深深忧郁\n不知去向渴望何处\n[chorus]\n推开木门香气弥漫\n熟悉的角落陌生人看", "model": "minimax/music-2.5+", "output_format": "url", "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆" }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "audio" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/music/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "outputs": { "all_results": "One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.", "family": "audio", "fields": [ { "name": "data.audio", "type": "string" }, { "name": "data.audio_url", "type": "string" }, { "name": "data.status", "type": "integer" } ], "format": [ "mp3", "wav" ] }, "parameters": [ { "default_known": false, "enum": [ "minimax/music-2.5+" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "default_known": false, "enum_known": false, "maxLength": 2000, "minLength": 10, "name": "prompt", "required": true, "type": "string" }, { "default_known": false, "enum_known": false, "maxLength": 3500, "minLength": 10, "name": "lyrics", "required": true, "type": "string" }, { "default": false, "default_known": true, "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" }, { "default": "hex", "default_known": true, "enum": [ "url", "hex" ], "enum_known": true, "name": "output_format", "required": false, "type": "string" }, { "additionalProperties": false, "default_known": false, "enum_known": false, "name": "audio_setting", "properties": { "bitrate": { "enum": [ 32000, 64000, 128000, 256000 ], "type": "integer" }, "format": { "enum": [ "mp3", "wav" ], "type": "string" }, "sample_rate": { "enum": [ 16000, 24000, 32000, 44100 ], "type": "integer" } }, "required": false, "type": "object" }, { "default_known": false, "enum": [ 16000, 24000, 32000, 44100 ], "enum_known": true, "name": "audio_setting.sample_rate", "required": false, "type": "integer" }, { "default_known": false, "enum": [ 32000, 64000, 128000, 256000 ], "enum_known": true, "name": "audio_setting.bitrate", "required": false, "type": "integer" }, { "default_known": false, "enum": [ "mp3", "wav" ], "enum_known": true, "name": "audio_setting.format", "required": false, "type": "string" }, { "default": false, "default_known": true, "enum_known": false, "name": "aigc_watermark", "required": false, "type": "boolean" } ], "request_schema": { "additionalProperties": false, "properties": { "aigc_watermark": { "default": false, "type": "boolean" }, "audio_setting": { "additionalProperties": false, "properties": { "bitrate": { "enum": [ 32000, 64000, 128000, 256000 ], "type": "integer" }, "format": { "enum": [ "mp3", "wav" ], "type": "string" }, "sample_rate": { "enum": [ 16000, 24000, 32000, 44100 ], "type": "integer" } }, "type": "object" }, "lyrics": { "maxLength": 3500, "minLength": 10, "type": "string" }, "model": { "enum": [ "minimax/music-2.5+" ], "type": "string" }, "output_format": { "default": "hex", "enum": [ "url", "hex" ], "type": "string" }, "prompt": { "maxLength": 2000, "minLength": 10, "type": "string" }, "stream": { "default": false, "enum": [ false ], "type": "boolean" } }, "required": [ "model", "prompt", "lyrics" ], "type": "object" }, "schema_template": { "body": { "audio_setting": { "bitrate": 256000, "format": "mp3", "sample_rate": 44100 }, "lyrics": "[verse]\n街灯微亮晚风轻抚\n影子拉长独自漫步\n旧外套裹着深深忧郁\n不知去向渴望何处\n[chorus]\n推开木门香气弥漫\n熟悉的角落陌生人看", "model": "minimax/music-2.5+", "output_format": "url", "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆" }, "content_type": "application/json" } }, "input": { "conditions": [ "Use a nonstreaming request. MP3 and WAV are available; a PCM control is absent from this method." ], "content_type": "application/json", "material_types": [ "text" ], "optional": [ "stream", "output_format", "audio_setting", "aigc_watermark" ], "required": [ "model", "prompt", "lyrics" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "audio" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/music/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/music/generations" }, "method_aliases": [], "output": { "all_results": "One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.", "family": "audio", "fields": [ { "name": "data.audio", "type": "string" }, { "name": "data.audio_url", "type": "string" }, { "name": "data.status", "type": "integer" } ], "format": [ "mp3", "wav" ] } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_quantity": "one request" }, "label": "Per request", "units": [ { "amount": "0.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": true, "estimate_only": false, "key": "per_request", "label": "per request", "native_amount_usd_per_unit": "0.3", "native_quantity": 1, "public_unit_label": "per request", "quantity": 1, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "per_request" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=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\"}')\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\n# Submit once. Retain the complete result, original identifiers and every response header.\n", "label": "curl · create once and retain the complete result", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "music", "http": "POST", "img_in": null, "img_out": null, "in": null, "input": [ "text" ], "label": "Music", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "audio" ], "path": "/v1/music/generations", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "per_request", "cache_read_price": null, "cache_write_1h_price": null, "cache_write_price": null, "fast_multiplier": null, "flex_multiplier": null, "image_input_price": null, "image_output_price": null, "input_price": null, "intervals": [], "max_reasoning_effort_multiplier": null, "output_price": null, "per_request_price": "0.3" }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_quantity": "one request" }, "label": "Per request", "units": [ { "amount": "0.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": true, "estimate_only": false, "key": "per_request", "label": "per request", "native_amount_usd_per_unit": "0.3", "native_quantity": 1, "public_unit_label": "per request", "quantity": 1, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "per_request" } ] } ], "request_model_id": "minimax/music-2.5+", "route_label": "Ultra", "status_reads": [], "tiers": [], "unit": "per_request", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": true, "estimate_only": false, "key": "per_request", "label": "per request", "native_amount_usd_per_unit": "0.3", "native_quantity": 1, "public_unit_label": "per request", "quantity": 1, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "per_request" } ] } }, { "html": "
MM

MiniMax: Music 2.5+

MiniMax /music-2.5+

入門

MiniMax Music 2.5+可根據風格與情緒提示詞及提供的歌詞生成音樂。其同步音樂規格接受10至2,000個字元的prompt、10至3,500個字元的lyrics，並提供MP3或WAV輸出。

接受的輸入
文字
結果
音訊
關於模型

此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。

MiniMax Music 2.5+可根據書面音樂需求與歌詞建立音樂。選擇minimax/music-2.5+即可使用此確切版本；music-2.5+是其已設定的別名。其音樂方法使用含有model、prompt與lyrics的JSON請求，並產生音訊。它可將書面歌曲概念轉為試聽草稿、為提供的歌詞譜曲，或在進一步編輯前探索作品。

使用prompt描述音樂風格、情緒與場景，lyrics則提供要演唱的文字。實用需求可以要求一首適合安靜咖啡館的內省民謠，以主歌建立場景，並以副歌重複核心概念。請將音樂方向放在prompt，預期歌詞放在lyrics，讓文字在作品中具有清楚用途。

使用Music 2.5+時，prompt必須包含10至2,000個字元，lyrics必須包含10至3,500個字元。請在請求中同時包含這兩個文字欄位與所選模型。利用prompt篇幅說明重要的音樂選擇，再於lyrics提供完整預期歌詞。相較於將不相關指示分散在兩個欄位，精簡而完整的需求更容易與回傳歌曲比較。

請以換行字元分隔歌詞行。[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 可用 · 輸入與方法

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\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=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"}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\n# Submit once. Retain the complete result, original identifiers and every response header.\n

接收並儲存結果

Ailoot Ultra · Music

mp3,wav

保留所有已完成的結果

請保留所有完整傳回的回應、檔案與內容區塊。

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

minimax/music-2.5+, music-2.5+

", "method_identity": { "effective_request_model_id": "music-2.5+", "fmt": "music", "http": "POST", "path": "/v1/music/generations", "request_model_id": "music-2.5+", "route_label": "Ultra" }, "method_key": "Ultra|music|/v1/music/generations|music-2.5%2B", "ordinal": 1, "rawMethod": { "available": null, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response, all actual results, original identifiers, usage and response headers.", "authentication": { "api_key_source": "AILOOT_API_KEY", "header": "Authorization: Bearer" }, "example_body": { "audio_setting": { "bitrate": 256000, "format": "mp3", "sample_rate": 44100 }, "lyrics": "[verse]\n街灯微亮晚风轻抚\n影子拉长独自漫步\n旧外套裹着深深忧郁\n不知去向渴望何处\n[chorus]\n推开木门香气弥漫\n熟悉的角落陌生人看", "model": "music-2.5+", "output_format": "url", "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆" }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "audio" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/music/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "outputs": { "all_results": "One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.", "family": "audio", "fields": [ { "name": "data.audio", "type": "string" }, { "name": "data.audio_url", "type": "string" }, { "name": "data.status", "type": "integer" } ], "format": [ "mp3", "wav" ] }, "parameters": [ { "default_known": false, "enum": [ "music-2.5+" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "default_known": false, "enum_known": false, "maxLength": 2000, "minLength": 10, "name": "prompt", "required": true, "type": "string" }, { "default_known": false, "enum_known": false, "maxLength": 3500, "minLength": 10, "name": "lyrics", "required": true, "type": "string" }, { "default": false, "default_known": true, "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" }, { "default": "hex", "default_known": true, "enum": [ "url", "hex" ], "enum_known": true, "name": "output_format", "required": false, "type": "string" }, { "additionalProperties": false, "default_known": false, "enum_known": false, "name": "audio_setting", "properties": { "bitrate": { "enum": [ 32000, 64000, 128000, 256000 ], "type": "integer" }, "format": { "enum": [ "mp3", "wav" ], "type": "string" }, "sample_rate": { "enum": [ 16000, 24000, 32000, 44100 ], "type": "integer" } }, "required": false, "type": "object" }, { "default_known": false, "enum": [ 16000, 24000, 32000, 44100 ], "enum_known": true, "name": "audio_setting.sample_rate", "required": false, "type": "integer" }, { "default_known": false, "enum": [ 32000, 64000, 128000, 256000 ], "enum_known": true, "name": "audio_setting.bitrate", "required": false, "type": "integer" }, { "default_known": false, "enum": [ "mp3", "wav" ], "enum_known": true, "name": "audio_setting.format", "required": false, "type": "string" }, { "default": false, "default_known": true, "enum_known": false, "name": "aigc_watermark", "required": false, "type": "boolean" } ], "request_schema": { "additionalProperties": false, "properties": { "aigc_watermark": { "default": false, "type": "boolean" }, "audio_setting": { "additionalProperties": false, "properties": { "bitrate": { "enum": [ 32000, 64000, 128000, 256000 ], "type": "integer" }, "format": { "enum": [ "mp3", "wav" ], "type": "string" }, "sample_rate": { "enum": [ 16000, 24000, 32000, 44100 ], "type": "integer" } }, "type": "object" }, "lyrics": { "maxLength": 3500, "minLength": 10, "type": "string" }, "model": { "enum": [ "music-2.5+" ], "type": "string" }, "output_format": { "default": "hex", "enum": [ "url", "hex" ], "type": "string" }, "prompt": { "maxLength": 2000, "minLength": 10, "type": "string" }, "stream": { "default": false, "enum": [ false ], "type": "boolean" } }, "required": [ "model", "prompt", "lyrics" ], "type": "object" }, "schema_template": { "body": { "audio_setting": { "bitrate": 256000, "format": "mp3", "sample_rate": 44100 }, "lyrics": "[verse]\n街灯微亮晚风轻抚\n影子拉长独自漫步\n旧外套裹着深深忧郁\n不知去向渴望何处\n[chorus]\n推开木门香气弥漫\n熟悉的角落陌生人看", "model": "music-2.5+", "output_format": "url", "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆" }, "content_type": "application/json" } }, "input": { "conditions": [ "Use a nonstreaming request. MP3 and WAV are available; a PCM control is absent from this method." ], "content_type": "application/json", "material_types": [ "text" ], "optional": [ "stream", "output_format", "audio_setting", "aigc_watermark" ], "required": [ "model", "prompt", "lyrics" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "audio" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/music/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/music/generations" }, "method_aliases": [], "output": { "all_results": "One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.", "family": "audio", "fields": [ { "name": "data.audio", "type": "string" }, { "name": "data.audio_url", "type": "string" }, { "name": "data.status", "type": "integer" } ], "format": [ "mp3", "wav" ] } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_quantity": "one request" }, "label": "Per request", "units": [ { "amount": "0.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": true, "estimate_only": false, "key": "per_request", "label": "per request", "native_amount_usd_per_unit": "0.3", "native_quantity": 1, "public_unit_label": "per request", "quantity": 1, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "per_request" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=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\"}')\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\n# Submit once. Retain the complete result, original identifiers and every response header.\n", "label": "curl · create once and retain the complete result", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "music", "http": "POST", "img_in": null, "img_out": null, "in": null, "input": [ "text" ], "label": "Music", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "audio" ], "path": "/v1/music/generations", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "per_request", "cache_read_price": null, "cache_write_1h_price": null, "cache_write_price": null, "fast_multiplier": null, "flex_multiplier": null, "image_input_price": null, "image_output_price": null, "input_price": null, "intervals": [], "max_reasoning_effort_multiplier": null, "output_price": null, "per_request_price": "0.3" }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_quantity": "one request" }, "label": "Per request", "units": [ { "amount": "0.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": true, "estimate_only": false, "key": "per_request", "label": "per request", "native_amount_usd_per_unit": "0.3", "native_quantity": 1, "public_unit_label": "per request", "quantity": 1, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "per_request" } ] } ], "request_model_id": "music-2.5+", "route_label": "Ultra", "status_reads": [], "tiers": [], "unit": "per_request", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": true, "estimate_only": false, "key": "per_request", "label": "per request", "native_amount_usd_per_unit": "0.3", "native_quantity": 1, "public_unit_label": "per request", "quantity": 1, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "per_request" } ] } } ], "model_id": "minimax/music-2.5+", "nativeProvenance": { "input_facts_canonical_sha256": "bdcef0f5111c2b82e91606076779e825b0e6a5872b706e51ef669d246ccc257f", "input_html_sha256": "92abb6e63daa509bc54bb0802d2b5c95a2639599acf7a41042fb49c57361b066", "private_audit_sha256": "9f1247b94161688b7ad1a9fc8c157cb38bfa4031c073f2ca0af9f7142605ceea", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/zh-hant-tw/minimax-music-2-5-u002b/", "description": "MiniMax Music 2.5+可根據風格與情緒提示詞及提供的歌詞生成音樂。其同步音樂規格接受10至2,000個字元的prompt、10至3,500個字元的lyrics，並提供MP3或WAV輸出。", "locale": "zh-hant-tw", "md_url": "https://ailoot.ai/models/zh-hant-tw/minimax-music-2-5-u002b/index.md", "title": "MiniMax: Music 2.5+ — Ailoot", "url": "https://ailoot.ai/models/zh-hant-tw/minimax-music-2-5-u002b/" }, "rawModel": { "about": "MiniMax Music 2.5+可根據書面音樂需求與歌詞建立音樂。選擇minimax/music-2.5+即可使用此確切版本；music-2.5+是其已設定的別名。其音樂方法使用含有model、prompt與lyrics的JSON請求，並產生音訊。它可將書面歌曲概念轉為試聽草稿、為提供的歌詞譜曲，或在進一步編輯前探索作品。\n\n使用prompt描述音樂風格、情緒與場景，lyrics則提供要演唱的文字。實用需求可以要求一首適合安靜咖啡館的內省民謠，以主歌建立場景，並以副歌重複核心概念。請將音樂方向放在prompt，預期歌詞放在lyrics，讓文字在作品中具有清楚用途。\n\n使用Music 2.5+時，prompt必須包含10至2,000個字元，lyrics必須包含10至3,500個字元。請在請求中同時包含這兩個文字欄位與所選模型。利用prompt篇幅說明重要的音樂選擇，再於lyrics提供完整預期歌詞。相較於將不相關指示分散在兩個欄位，精簡而完整的需求更容易與回傳歌曲比較。\n\n請以換行字元分隔歌詞行。[Intro]、[Verse]、[Pre Chorus]、[Chorus]、[Bridge]與[Outro]等段落標籤可識別預期結構；文件所列標籤也包含[Interlude]、[Post Chorus]、[Transition]、[Break]、[Hook]、[Build Up]、[Inst]與[Solo]。請將實際歌詞放在對應段落標籤下，並有意識地安排重複段落。這些標記為作品提供依循結構；請檢視完成歌曲實際如何呈現轉場與重複。\n\naudio_setting物件提供sample_rate值16000、24000、32000或44100，bitrate值32000、64000、128000或256000，以及format值mp3或wav。請依下一個編輯或播放步驟選擇檔案設定，並連同需求保留。公開範例請求44100、256000與mp3；這些是範例選擇，並非三個欄位共通的通用預設值。\n\n所選音樂工作流程採同步、非串流方式。文件所列output_format選項為url與hex，結構描述預設值為hex；所選範例則明確請求url。若輸出為URL，請使用回傳的Ailoot連結下載已儲存音訊。hex結果代表音訊位元組，必須先解碼成所選檔案格式才能播放。回應可能同時含有同一段生成音訊的audio與audio_url位置；請將該結果保留為同一首歌曲。\n\n請將完成音訊連同歌詞、音樂需求、確切模型ID與要求的檔案設定一併儲存。放入專案前，請聆聽並檢查預期歌詞、段落順序與音樂方向。若請求結束時沒有完整結果，請保留原始請求識別資訊與回應資訊，以供檢查結果；自動發出替代請求可能建立另一首歌曲。修訂時，可修改特定歌詞或音樂指示，並保留其餘需求以供比較。", "alias_of": null, "aliases": [ "music-2.5+" ], "author": "MiniMax", "ctx": null, "formats": [ "music" ], "id": "minimax/music-2.5+", "input": [ "text" ], "kind": "music", "max_out": null, "methods": [ { "available": null, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response, all actual results, original identifiers, usage and response headers.", "authentication": { "api_key_source": "AILOOT_API_KEY", "header": "Authorization: Bearer" }, "example_body": { "audio_setting": { "bitrate": 256000, "format": "mp3", "sample_rate": 44100 }, "lyrics": "[verse]\n街灯微亮晚风轻抚\n影子拉长独自漫步\n旧外套裹着深深忧郁\n不知去向渴望何处\n[chorus]\n推开木门香气弥漫\n熟悉的角落陌生人看", "model": "minimax/music-2.5+", "output_format": "url", "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆" }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "audio" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/music/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "outputs": { "all_results": "One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.", "family": "audio", "fields": [ { "name": "data.audio", "type": "string" }, { "name": "data.audio_url", "type": "string" }, { "name": "data.status", "type": "integer" } ], "format": [ "mp3", "wav" ] }, "parameters": [ { "default_known": false, "enum": [ "minimax/music-2.5+" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "default_known": false, "enum_known": false, "maxLength": 2000, "minLength": 10, "name": "prompt", "required": true, "type": "string" }, { "default_known": false, "enum_known": false, "maxLength": 3500, "minLength": 10, "name": "lyrics", "required": true, "type": "string" }, { "default": false, "default_known": true, "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" }, { "default": "hex", "default_known": true, "enum": [ "url", "hex" ], "enum_known": true, "name": "output_format", "required": false, "type": "string" }, { "additionalProperties": false, "default_known": false, "enum_known": false, "name": "audio_setting", "properties": { "bitrate": { "enum": [ 32000, 64000, 128000, 256000 ], "type": "integer" }, "format": { "enum": [ "mp3", "wav" ], "type": "string" }, "sample_rate": { "enum": [ 16000, 24000, 32000, 44100 ], "type": "integer" } }, "required": false, "type": "object" }, { "default_known": false, "enum": [ 16000, 24000, 32000, 44100 ], "enum_known": true, "name": "audio_setting.sample_rate", "required": false, "type": "integer" }, { "default_known": false, "enum": [ 32000, 64000, 128000, 256000 ], "enum_known": true, "name": "audio_setting.bitrate", "required": false, "type": "integer" }, { "default_known": false, "enum": [ "mp3", "wav" ], "enum_known": true, "name": "audio_setting.format", "required": false, "type": "string" }, { "default": false, "default_known": true, "enum_known": false, "name": "aigc_watermark", "required": false, "type": "boolean" } ], "request_schema": { "additionalProperties": false, "properties": { "aigc_watermark": { "default": false, "type": "boolean" }, "audio_setting": { "additionalProperties": false, "properties": { "bitrate": { "enum": [ 32000, 64000, 128000, 256000 ], "type": "integer" }, "format": { "enum": [ "mp3", "wav" ], "type": "string" }, "sample_rate": { "enum": [ 16000, 24000, 32000, 44100 ], "type": "integer" } }, "type": "object" }, "lyrics": { "maxLength": 3500, "minLength": 10, "type": "string" }, "model": { "enum": [ "minimax/music-2.5+" ], "type": "string" }, "output_format": { "default": "hex", "enum": [ "url", "hex" ], "type": "string" }, "prompt": { "maxLength": 2000, "minLength": 10, "type": "string" }, "stream": { "default": false, "enum": [ false ], "type": "boolean" } }, "required": [ "model", "prompt", "lyrics" ], "type": "object" }, "schema_template": { "body": { "audio_setting": { "bitrate": 256000, "format": "mp3", "sample_rate": 44100 }, "lyrics": "[verse]\n街灯微亮晚风轻抚\n影子拉长独自漫步\n旧外套裹着深深忧郁\n不知去向渴望何处\n[chorus]\n推开木门香气弥漫\n熟悉的角落陌生人看", "model": "minimax/music-2.5+", "output_format": "url", "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆" }, "content_type": "application/json" } }, "input": { "conditions": [ "Use a nonstreaming request. MP3 and WAV are available; a PCM control is absent from this method." ], "content_type": "application/json", "material_types": [ "text" ], "optional": [ "stream", "output_format", "audio_setting", "aigc_watermark" ], "required": [ "model", "prompt", "lyrics" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "audio" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/music/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/music/generations" }, "method_aliases": [], "output": { "all_results": "One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.", "family": "audio", "fields": [ { "name": "data.audio", "type": "string" }, { "name": "data.audio_url", "type": "string" }, { "name": "data.status", "type": "integer" } ], "format": [ "mp3", "wav" ] } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_quantity": "one request" }, "label": "Per request", "units": [ { "amount": "0.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": true, "estimate_only": false, "key": "per_request", "label": "per request", "native_amount_usd_per_unit": "0.3", "native_quantity": 1, "public_unit_label": "per request", "quantity": 1, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "per_request" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=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\"}')\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\n# Submit once. Retain the complete result, original identifiers and every response header.\n", "label": "curl · create once and retain the complete result", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "music", "http": "POST", "img_in": null, "img_out": null, "in": null, "input": [ "text" ], "label": "Music", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "audio" ], "path": "/v1/music/generations", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "per_request", "cache_read_price": null, "cache_write_1h_price": null, "cache_write_price": null, "fast_multiplier": null, "flex_multiplier": null, "image_input_price": null, "image_output_price": null, "input_price": null, "intervals": [], "max_reasoning_effort_multiplier": null, "output_price": null, "per_request_price": "0.3" }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_quantity": "one request" }, "label": "Per request", "units": [ { "amount": "0.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": true, "estimate_only": false, "key": "per_request", "label": "per request", "native_amount_usd_per_unit": "0.3", "native_quantity": 1, "public_unit_label": "per request", "quantity": 1, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "per_request" } ] } ], "request_model_id": "minimax/music-2.5+", "route_label": "Ultra", "status_reads": [], "tiers": [], "unit": "per_request", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": true, "estimate_only": false, "key": "per_request", "label": "per request", "native_amount_usd_per_unit": "0.3", "native_quantity": 1, "public_unit_label": "per request", "quantity": 1, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "per_request" } ] }, { "available": null, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response, all actual results, original identifiers, usage and response headers.", "authentication": { "api_key_source": "AILOOT_API_KEY", "header": "Authorization: Bearer" }, "example_body": { "audio_setting": { "bitrate": 256000, "format": "mp3", "sample_rate": 44100 }, "lyrics": "[verse]\n街灯微亮晚风轻抚\n影子拉长独自漫步\n旧外套裹着深深忧郁\n不知去向渴望何处\n[chorus]\n推开木门香气弥漫\n熟悉的角落陌生人看", "model": "music-2.5+", "output_format": "url", "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆" }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "audio" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/music/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "outputs": { "all_results": "One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.", "family": "audio", "fields": [ { "name": "data.audio", "type": "string" }, { "name": "data.audio_url", "type": "string" }, { "name": "data.status", "type": "integer" } ], "format": [ "mp3", "wav" ] }, "parameters": [ { "default_known": false, "enum": [ "music-2.5+" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "default_known": false, "enum_known": false, "maxLength": 2000, "minLength": 10, "name": "prompt", "required": true, "type": "string" }, { "default_known": false, "enum_known": false, "maxLength": 3500, "minLength": 10, "name": "lyrics", "required": true, "type": "string" }, { "default": false, "default_known": true, "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" }, { "default": "hex", "default_known": true, "enum": [ "url", "hex" ], "enum_known": true, "name": "output_format", "required": false, "type": "string" }, { "additionalProperties": false, "default_known": false, "enum_known": false, "name": "audio_setting", "properties": { "bitrate": { "enum": [ 32000, 64000, 128000, 256000 ], "type": "integer" }, "format": { "enum": [ "mp3", "wav" ], "type": "string" }, "sample_rate": { "enum": [ 16000, 24000, 32000, 44100 ], "type": "integer" } }, "required": false, "type": "object" }, { "default_known": false, "enum": [ 16000, 24000, 32000, 44100 ], "enum_known": true, "name": "audio_setting.sample_rate", "required": false, "type": "integer" }, { "default_known": false, "enum": [ 32000, 64000, 128000, 256000 ], "enum_known": true, "name": "audio_setting.bitrate", "required": false, "type": "integer" }, { "default_known": false, "enum": [ "mp3", "wav" ], "enum_known": true, "name": "audio_setting.format", "required": false, "type": "string" }, { "default": false, "default_known": true, "enum_known": false, "name": "aigc_watermark", "required": false, "type": "boolean" } ], "request_schema": { "additionalProperties": false, "properties": { "aigc_watermark": { "default": false, "type": "boolean" }, "audio_setting": { "additionalProperties": false, "properties": { "bitrate": { "enum": [ 32000, 64000, 128000, 256000 ], "type": "integer" }, "format": { "enum": [ "mp3", "wav" ], "type": "string" }, "sample_rate": { "enum": [ 16000, 24000, 32000, 44100 ], "type": "integer" } }, "type": "object" }, "lyrics": { "maxLength": 3500, "minLength": 10, "type": "string" }, "model": { "enum": [ "music-2.5+" ], "type": "string" }, "output_format": { "default": "hex", "enum": [ "url", "hex" ], "type": "string" }, "prompt": { "maxLength": 2000, "minLength": 10, "type": "string" }, "stream": { "default": false, "enum": [ false ], "type": "boolean" } }, "required": [ "model", "prompt", "lyrics" ], "type": "object" }, "schema_template": { "body": { "audio_setting": { "bitrate": 256000, "format": "mp3", "sample_rate": 44100 }, "lyrics": "[verse]\n街灯微亮晚风轻抚\n影子拉长独自漫步\n旧外套裹着深深忧郁\n不知去向渴望何处\n[chorus]\n推开木门香气弥漫\n熟悉的角落陌生人看", "model": "music-2.5+", "output_format": "url", "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆" }, "content_type": "application/json" } }, "input": { "conditions": [ "Use a nonstreaming request. MP3 and WAV are available; a PCM control is absent from this method." ], "content_type": "application/json", "material_types": [ "text" ], "optional": [ "stream", "output_format", "audio_setting", "aigc_watermark" ], "required": [ "model", "prompt", "lyrics" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "audio" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/music/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/music/generations" }, "method_aliases": [], "output": { "all_results": "One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.", "family": "audio", "fields": [ { "name": "data.audio", "type": "string" }, { "name": "data.audio_url", "type": "string" }, { "name": "data.status", "type": "integer" } ], "format": [ "mp3", "wav" ] } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_quantity": "one request" }, "label": "Per request", "units": [ { "amount": "0.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": true, "estimate_only": false, "key": "per_request", "label": "per request", "native_amount_usd_per_unit": "0.3", "native_quantity": 1, "public_unit_label": "per request", "quantity": 1, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "per_request" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=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\"}')\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\n# Submit once. Retain the complete result, original identifiers and every response header.\n", "label": "curl · create once and retain the complete result", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "music", "http": "POST", "img_in": null, "img_out": null, "in": null, "input": [ "text" ], "label": "Music", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "audio" ], "path": "/v1/music/generations", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "per_request", "cache_read_price": null, "cache_write_1h_price": null, "cache_write_price": null, "fast_multiplier": null, "flex_multiplier": null, "image_input_price": null, "image_output_price": null, "input_price": null, "intervals": [], "max_reasoning_effort_multiplier": null, "output_price": null, "per_request_price": "0.3" }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_quantity": "one request" }, "label": "Per request", "units": [ { "amount": "0.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": true, "estimate_only": false, "key": "per_request", "label": "per request", "native_amount_usd_per_unit": "0.3", "native_quantity": 1, "public_unit_label": "per request", "quantity": 1, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "per_request" } ] } ], "request_model_id": "music-2.5+", "route_label": "Ultra", "status_reads": [], "tiers": [], "unit": "per_request", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": true, "estimate_only": false, "key": "per_request", "label": "per request", "native_amount_usd_per_unit": "0.3", "native_quantity": 1, "public_unit_label": "per request", "quantity": 1, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "per_request" } ] } ], "model_aliases": [ { "canonical_model_id": "minimax/music-2.5+", "request_model_id": "minimax/music-2.5+", "route_label": "Ultra" }, { "canonical_model_id": "minimax/music-2.5+", "request_model_id": "music-2.5+", "route_label": "Ultra" } ], "name": "MiniMax: Music 2.5+", "price": { "in": "0.3", "in_label": "per request", "out": null, "out_label": null, "sort_in": null, "sort_out": null, "varies": false }, "short": "MiniMax Music 2.5+可根據風格與情緒提示詞及提供的歌詞生成音樂。其同步音樂規格接受10至2,000個字元的prompt、10至3,500個字元的lyrics，並提供MP3或WAV輸出。" }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 }, { "contract_json_pointer": "/methods/1/rawMethod/contract", "html_json_pointer": "/methods/1/html", "method_ordinal": 1 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod", "/methods/1/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "MiniMax Music 2.5+可根據風格與情緒提示詞及提供的歌詞生成音樂。其同步音樂規格接受10至2,000個字元的prompt、10至3,500個字元的lyrics，並提供MP3或WAV輸出。", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "315876f424797bf70ca7b068b3d4c49197ec851d9dc17326e9dca1df1a47f19f", "renderer_sha256": "13a3fc1b22d07359278e2249d630bfc9bb9e6416c71ba53def933fb5a903660b" }, "sourceRevision": "04ecbe88cd547309b0f61ad5bcec2c875bcdea40e3e9328089749f93854825dc" }