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.ai/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.ai/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.ai/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.ai/anthropic。通过该接口调用时，思考内容以独立的 thinking 块返回，回答位于 text 块中，无需自行去掉 think 标签。

import os
import anthropic
 
client = anthropic.Anthropic(base_url="https://api.ofox.ai/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 开放平台 · 文档 

常见问题