MiniMax 系列

MiniMax 的文字模型，包括 MiniMax M3、M2.7 與 M2.7 HighSpeed。透過 OpenAI 相容介面呼叫，同時支援 Anthropic 原生介面，可在 Claude Code 中使用。MiniMax 的影片模型請見 Hailuo（MiniMax）。

常見任務

模型

完整的模型清單與即時價格請參閱模型頁 。模型 ID 的前綴為 minimax/，可省略；寫成官方名稱 MiniMax-M3 會回傳 404。

以上模型由 MiniMax 官方（minimax）提供，支援 Chat Completions、Responses 與 Anthropic 原生介面。

呼叫範例

import os
import re
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.io/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="minimax/minimax-m3",
    messages=[{"role": "user", "content": "用一句話解釋什麼是冪等性。"}],
)
content = resp.choices[0].message.content
answer = re.sub(r"<think>.*?</think>\s*", "", content, flags=re.S)
print(answer)

curl https://api.ofox.io/v1/chat/completions \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/minimax-m3",
    "messages": [{"role": "user", "content": "用一句話解釋什麼是冪等性。"}]
  }'

思考內容

MiniMax 模型預設開啟思考。透過 OpenAI 相容介面呼叫時，message.content 的開頭是以 <think>…</think> 包裹的思考內容，之後才是回答；串流回應同樣在 delta.content 中回傳。上方範例用正規表示式移除了這一段。

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.io/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="minimax/minimax-m3",
    messages=[{"role": "user", "content": "一個數加上它的 3 倍再減去 12 等於 36，這個數是多少？只回答數字。"}],
    extra_body={"thinking": {"type": "disabled"}},
)
print(resp.choices[0].message.content)

• MiniMax M3 的 thinking.type 只接受 adaptive 與 disabled，傳入 enabled 會回傳 400。
• 思考 token 計入 max_tokens。上限設得過小時，回答可能停在思考內容中，finish_reason 為 length。
• 思考 token 依輸出單價計費，數量請見 usage.completion_tokens_details.reasoning_tokens。

在 Claude Code 中使用

MiniMax 模型支援 Anthropic 原生介面，位址為 https://api.ofox.io/anthropic。透過該介面呼叫時，思考內容以獨立的 thinking 區塊回傳，回答位於 text 區塊中，不需要自行移除 think 標籤。

import os
import anthropic
 
client = anthropic.Anthropic(base_url="https://api.ofox.io/anthropic", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.messages.create(
    model="minimax/minimax-m2.7",
    max_tokens=4096,
    messages=[{"role": "user", "content": "一個數加上它的 3 倍再減去 12 等於 36，這個數是多少？"}],
)
for block in resp.content:
    print(block.type, ":", getattr(block, "thinking", None) or block.text)

• MiniMax M2.7、M2.7 HighSpeed 一律回傳 thinking 區塊。
• MiniMax M3 傳入 "thinking": {"type": "adaptive"} 或 {"type": "enabled", "budget_tokens": 2000} 時回傳 thinking 區塊，傳入 {"type": "disabled"} 時只回傳 text 區塊。

Claude Code 的完整設定步驟請見 Claude Code 設定。

圖片輸入

僅 MiniMax M3 支援圖片輸入，使用標準的 image_url 內容區塊，寫法請見視覺理解。MiniMax M2.7 與 M2.7 HighSpeed 僅支援文字，需要辨識圖片時請使用 M3。

其他功能

• 工具呼叫：使用標準的 tools 參數，回傳 tool_calls。
• 快取：自動快取重複的請求前綴，命中量請見 usage.prompt_tokens_details.cached_tokens。實測約 5600 token 的相同前綴，第二次請求的快取命中超過 5000 token。
• 結構化輸出：實測傳入 response_format 的 json_schema 後，回答仍為一般文字。需要 JSON 時，請在提示詞中說明欄位並自行解析。

常見錯誤

其他通用錯誤請見錯誤處理。

官方文件

• MiniMax 開放平台 · 文件 

常見問題