Anthropic SDK

为了满足开发者对 Anthropic API 生态的使用需求，我们的 API 新增了对 Anthropic API 格式的支持。通过简单的配置，即可将 MiniMax 的能力接入到 Anthropic API 生态中。

快速开始

1. 安装 Anthropic SDK

pip install anthropic

npm install @anthropic-ai/sdk

2. 配置环境变量

export ANTHROPIC_BASE_URL=https://api.minimax.cn/anthropic
export ANTHROPIC_API_KEY=${YOUR_API_KEY}

配置方法见配置环境变量。

3. 调用 API

Python

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="MiniMax-M3.1-Flash",
    output_config={"effort": "max"},
    max_tokens=4096,
    system="You are a helpful assistant.",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Hi, how are you?"
                }
            ]
        }
    ]
)

for block in message.content:
    if block.type == "thinking":
        print(f"Thinking:\n{block.thinking}\n")
    elif block.type == "text":
        print(f"Text:\n{block.text}\n")

4. 特别注意

在多轮 Function Call 对话中，必须将完整的模型返回（即 assistant 消息）添加到对话历史，以保持思维链的连续性：

将完整的 response.content（包含 thinking/text/tool_use 等所有块）添加到消息历史
response.content 是一个列表，包含多种类型的内容块，必须完整回传

支持的模型

使用 Anthropic SDK 时，支持以下模型。

模型名称	上下文窗口	模型介绍
MiniMax-M3.1-Flash	1,000,000	原生多模态、1M 上下文的 Frontier Coding 模型，思考深度可调
MiniMax-M3	1,000,000	原生多模态、1M 上下文的 Frontier Coding 模型

TPS（Tokens Per Second）的计算方式详见常见问题 > 接口相关。

Anthropic API 兼容接口支持 MiniMax-M3.1-Flash MiniMax-M3 模型。如需使用其他模型，请使用标准的 MiniMax API 接口。

兼容性说明

支持的参数

在使用 Anthropic SDK 接入时，我们支持以下输入参数：

参数	支持状态	说明
`model`	完全支持	支持 `MiniMax-M3.1-Flash` `MiniMax-M3` 模型
`messages`	部分支持	`MiniMax-M3.1-Flash` 和 `MiniMax-M3` 支持文本、图片、视频、工具调用、工具结果和 thinking 内容块
`max_tokens`	完全支持	最大生成 token 数。思考 token 也计入此上限，设置过小会导致 `stop_reason` 为 `max_tokens` 且无文本输出
`stream`	完全支持	流式响应
`system`	完全支持	系统提示词
`tool_choice`	部分支持	工具选择策略，仅支持 `auto`
`tools`	完全支持	工具定义
`thinking`	完全支持	`MiniMax-M3.1-Flash` 强制开启 thinking，传入 `disabled` 会返回 `400`。`MiniMax-M3` 默认关闭 thinking，可通过 `adaptive` 开启。
`output_config.effort`	完全支持	调节 `MiniMax-M3.1-Flash` 的思考深度，可取 `low`、`medium`、`high`、`xhigh`、`max`；省略时默认为 `max`。
`metadata`	完全支持	元信息
`service_tier`	完全支持	请求准入服务层级。支持的取值为 `standard` 和 `priority`；省略时默认使用 `standard`。`priority` 的价格为 `standard` 的 1.5 倍，并会确保请求获得优先准入，使其排在其他请求之前处理，从而带来更快响应并减少失败。`MiniMax-M3.1-Flash` 不支持该字段。
`temperature`	忽略	暂不支持指定，传入的值不会生效。`MiniMax-M3.1-Flash` 和 `MiniMax-M3` 固定使用 1
`top_p`	忽略	暂不支持指定，传入的值不会生效。`MiniMax-M3.1-Flash` 和 `MiniMax-M3` 固定使用 0.95。若传入，取值需在 (0, 1] 范围内
`top_k`	忽略	该参数会被忽略
`stop_sequences`	忽略	该参数会被忽略
`mcp_servers`	忽略	该参数会被忽略
`context_management`	忽略	该参数会被忽略
`container`	忽略	该参数会被忽略

Thinking 控制

thinking 参数用于控制模型是否可以输出 thinking 内容块。不同模型的行为不同：

模型	省略 `thinking`	`{"type": "adaptive"}`	`{"type": "disabled"}`
`MiniMax-M3.1-Flash`	开启 thinking	开启 thinking	返回 `400`，thinking 无法关闭
`MiniMax-M3`	关闭 thinking	开启 thinking	保持 thinking 关闭

传入 thinking: {"type": "disabled"} 时返回的错误信息：

model "MiniMax-M3.1-Flash" requires adaptive thinking; thinking.type="disabled" (including reasoning.effort=none) is not allowed (2013)

当响应包含 thinking 内容块时，后续轮次中应原样保留这些内容块，尤其是在工具调用对话中。

思考深度控制（仅 MiniMax-M3.1-Flash）

MiniMax-M3.1-Flash 支持通过 output_config.effort 调节思考深度，档位从低到高为 low、medium、high、xhigh、max。档位越高，模型思考越充分，输出的 thinking token 和响应耗时也越多。省略 output_config.effort 时默认为 max。 none 不支持，会返回 400。

curl

curl https://api.minimax.cn/anthropic/v1/messages \
  -H "Authorization: Bearer <MINIMAX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-M3.1-Flash",
    "max_tokens": 2048,
    "output_config": { "effort": "max" },
    "messages": [{ "role": "user", "content": "Hi, how are you?" }]
  }'

Messages 字段支持

字段类型	支持状态	说明
`type="text"`	完全支持	文本消息
`type="image"`	仅 M3.1-Flash / M3	通过 URL 或 base64 输入图片，支持 JPEG、PNG、GIF、WEBP
`type="video"`	仅 M3.1-Flash / M3	通过 URL、base64 或 `mm_file://{file_id}` 输入视频，支持 MP4、AVI、MOV、MKV
`type="tool_use"`	完全支持	工具调用
`type="tool_result"`	完全支持	工具调用结果
`type="thinking"`	完全支持	推理内容。多轮 thinking 对话中需要原样回带

对 MiniMax-M3.1-Flash 和 MiniMax-M3，URL 或 base64 视频最大 50 MB，图片最大 10 MB，请求体最大 64 MB。更大的视频请通过 Files API 上传后传入 mm_file://{file_id}，Files API 视频最大 512 MB。图片 token 用量会随图片尺寸和内容变化。以下是单张图片的粗略估算；准确用量以 POST /anthropic/v1/messages/count_tokens 或响应中的 usage 为准：

`detail`	单张图片粗略 token 用量
`low`	通常为几百 token，最高约 600
`default`	通常约 1k-3k token，最高约 5k
`high`	通常为数千 token，最高约 15k+

Anthropic API 兼容接口也支持 POST /anthropic/v1/messages/count_tokens，可用于 MiniMax-M3.1-Flash 和 MiniMax-M3 调用前预估输入 token 用量，不会生成模型输出。

示例代码

流式响应

Python

import anthropic

client = anthropic.Anthropic()

print("Starting stream response...\n")
print("=" * 60)
print("Thinking Process:")
print("=" * 60)

stream = client.messages.create(
    model="MiniMax-M3.1-Flash",
    output_config={"effort": "max"},
    max_tokens=4096,
    system="You are a helpful assistant.",
    messages=[
        {"role": "user", "content": [{"type": "text", "text": "Hi, how are you?"}]}
    ],
    stream=True,
)

reasoning_buffer = ""
text_buffer = ""

for chunk in stream:
    if chunk.type == "content_block_start":
        if hasattr(chunk, "content_block") and chunk.content_block:
            if chunk.content_block.type == "text":
                print("\n" + "=" * 60)
                print("Response Content:")
                print("=" * 60)

    elif chunk.type == "content_block_delta":
        if hasattr(chunk, "delta") and chunk.delta:
            if chunk.delta.type == "thinking_delta":
                # 流式输出 thinking 过程
                new_thinking = chunk.delta.thinking
                if new_thinking:
                    print(new_thinking, end="", flush=True)
                    reasoning_buffer += new_thinking
            elif chunk.delta.type == "text_delta":
                # 流式输出文本内容
                new_text = chunk.delta.text
                if new_text:
                    print(new_text, end="", flush=True)
                    text_buffer += new_text

print("\n")

注意事项

如果在使用模型过程中遇到任何问题：

通过邮箱 Model@minimax.io 等官方渠道联系我们的技术支持团队
在我们的 Github 仓库提交Issue

Anthropic API 兼容接口目前支持 MiniMax-M3.1-Flash MiniMax-M3 模型
部分 Anthropic 参数（如 temperature、top_p、top_k、stop_sequences、mcp_servers、context_management、container）会被忽略
MiniMax-M3.1-Flash 和 MiniMax-M3 支持通过 Anthropic 兼容内容块输入图片和视频

API 指引

文本

视频

图片

语音

文件

模型

历史接口

快速开始

1. 安装 Anthropic SDK

2. 配置环境变量

3. 调用 API

4. 特别注意

支持的模型

兼容性说明

支持的参数

Thinking 控制

思考深度控制（仅 MiniMax-M3.1-Flash）

Messages 字段支持

示例代码

流式响应

注意事项

​快速开始

​1. 安装 Anthropic SDK

​2. 配置环境变量

​3. 调用 API

​4. 特别注意

​支持的模型

​兼容性说明

​支持的参数

​Thinking 控制

​思考深度控制（仅 MiniMax-M3.1-Flash）

​Messages 字段支持

​示例代码

​流式响应

​注意事项

快速开始

1. 安装 Anthropic SDK

2. 配置环境变量

3. 调用 API

4. 特别注意

支持的模型

兼容性说明

支持的参数

Thinking 控制

思考深度控制（仅 MiniMax-M3.1-Flash）

Messages 字段支持

示例代码

流式响应

注意事项