MiniMax — OpenAI 格式

POST/v1/chat/completions

调用 MiniMax 系列模型进行文本对话，兼容 OpenAI Chat Completions 协议。

Bearer Token

模型介绍

MiniMax 推出的通用大语言模型，擅长中文创作、角色扮演、多轮对话等场景，响应自然流畅。

支持模型

MiniMax 模型列表

模型	上下文长度	最大输出	思考模式	工具调用	缓存	多模态
minimax-m3	245,000	8,000	✅	✅	✅	文本+图像

请求参数

请求参数

参数	类型	必填	默认值	描述
model	string	是	-	模型名称：minimax-m3
messages	array	是	-	消息列表，结构同 OpenAI 标准
stream	boolean	否	false	是否流式返回（SSE）
max_tokens	integer	否	-	最大输出 token 数
temperature	number	否	1.0	采样温度，0~2
top_p	number	否	1.0	核采样概率
tools	array	否	-	工具定义列表
tool_choice	string	否	auto	工具调用策略

请求示例

curl -X POST /v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-m3",
    "messages": [
      {"role": "user", "content": "写一首关于大海的五言绝句。"}
    ]
  }'

from openai import OpenAI

client = OpenAI(
    base_url="/v1",
    api_key="YOUR_API_KEY",
)

resp = client.chat.completions.create(
    model="minimax-m3",
    messages=[
        {"role": "user", "content": "写一首关于大海的五言绝句。"},
    ],
)
print(resp.choices[0].message.content)

响应示例

成功响应

{
  "id": "9c1f2e3d4a5b6c7d8e9f0a1b2c3d4e5f",
  "object": "chat.completion",
  "created": 1735661100,
  "model": "minimax-m3",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "潮退沙痕浅，风来海气凉。远帆天际没，一鸟入斜阳。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 40,
    "total_tokens": 50
  }
}

注意事项

• 响应 id 由平台按原厂形态归一：32 位 hex。
• MiniMax M3 的思考模式支持情况未取证：官方基线未登记该项，本页早期版本的能力表（✅）与注意事项（「暂不支持」）互相矛盾，现已统一按能力表表述，请以控制台与 MiniMax 官方文档为准。
• 本平台 OpenAI 兼容入口没有 cache 请求参数（传入会被忽略）；上下文缓存命中计价以 MiniMax 官方规则与本站价格页为准。
• 角色扮演场景建议在 system 消息中明确人设、语气、禁忌等约束。
• 图像输入支持 image_url 类型，URL 需可公开访问。