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.minimaxi.com/anthropic
export ANTHROPIC_API_KEY=${YOUR_API_KEY}

3. 调用 API

Python

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="MiniMax-M3",
    max_tokens=1000,
    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 MiniMax-M2.7 MiniMax-M2.7-highspeed MiniMax-M2.5 MiniMax-M2.5-highspeed MiniMax-M2.1 MiniMax-M2.1-highspeed MiniMax-M2 模型：

模型名称	上下文窗口	模型介绍
MiniMax-M3	1,000,000	最新 M 系列语言模型，适用于 Agent 推理、工具调用、代码和长上下文任务
MiniMax-M2.7	204,800	开启模型的自我迭代（输出速度约 60 TPS）
MiniMax-M2.7-highspeed	204,800	M2.7 极速版：效果不变，更快，更敏捷（输出速度约 100 TPS）
MiniMax-M2.5	204,800	顶尖性能与极致性价比，轻松驾驭复杂任务（输出速度约 60 TPS）
MiniMax-M2.5-highspeed	204,800	M2.5 极速版：效果不变，更快，更敏捷（输出速度约 100 TPS）
MiniMax-M2.1	204,800	强大多语言编程能力，全面升级编程体验（输出速度约 60 TPS）
MiniMax-M2.1-highspeed	204,800	M2.1 极速版：效果不变，更快，更敏捷（输出速度约 100 TPS）
MiniMax-M2	204,800	专为高效编码与 Agent 工作流而生

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

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

兼容性说明

支持的参数

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

参数	支持状态	说明
`model`	完全支持	支持 `MiniMax-M3` `MiniMax-M2.7` `MiniMax-M2.7-highspeed` `MiniMax-M2.5` `MiniMax-M2.5-highspeed` `MiniMax-M2.1` `MiniMax-M2.1-highspeed` `MiniMax-M2` 模型
`messages`	部分支持	`MiniMax-M3` 支持文本、图片、视频、工具调用、工具结果和 thinking 内容块。M2.7、M2.5、M2.1 和 M2 系列仅支持文本与工具调用相关内容块，不支持图片和视频输入
`max_tokens`	完全支持	最大生成 token 数
`stream`	完全支持	流式响应
`system`	完全支持	系统提示词
`temperature`	完全支持	取值范围 [0, 2]，控制输出随机性，建议取值 1
`tool_choice`	完全支持	工具选择策略
`tools`	完全支持	工具定义
`top_p`	完全支持	核采样参数，取值范围 [0, 1]，`MiniMax-M3` 默认值 0.95，M2.x 系列默认值 0.9
`thinking`	完全支持	MiniMax-M3 默认关闭 thinking，可通过 `adaptive` 开启。M2.x 模型的 thinking 无法关闭。
`metadata`	完全支持	元信息
`service_tier`	完全支持	请求准入服务层级。支持的取值为 `standard` 和 `priority`；省略时默认使用 `standard`。`priority` 的价格为 `standard` 的 1.5 倍，并会确保请求获得优先准入，使其排在其他请求之前处理，从而带来更快响应并减少失败。
`top_k`	忽略	该参数会被忽略
`stop_sequences`	忽略	该参数会被忽略
`mcp_servers`	忽略	该参数会被忽略
`context_management`	忽略	该参数会被忽略
`container`	忽略	该参数会被忽略

Thinking 控制

对于 MiniMax-M3，thinking 参数用于控制模型是否可以输出 thinking 内容块。

如果省略 thinking，默认关闭 thinking，响应不会包含 thinking 内容块。
设置 thinking: {"type": "adaptive"} 可显式开启 thinking。对于 MiniMax-M3，adaptive 等同于开启 thinking。
设置 thinking: {"type": "disabled"} 可显式保持 MiniMax-M3 的 thinking 输出关闭。
对于 M2.x 模型，thinking 无法关闭；即使传入 thinking: {"type": "disabled"}，thinking 仍会保持开启。

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

Messages 字段支持

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

对 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 调用前预估输入 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",
    max_tokens=1000,
    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@minimaxi.com 等官方渠道联系我们的技术支持团队
在我们的 Github 仓库提交Issue

Anthropic API 兼容接口目前支持 MiniMax-M3 MiniMax-M2.7 MiniMax-M2.7-highspeed MiniMax-M2.5 MiniMax-M2.5-highspeed MiniMax-M2.1 MiniMax-M2.1-highspeed MiniMax-M2 模型
temperature 参数取值范围为 [0, 2]，推荐使用1.0，超出范围会返回错误
部分 Anthropic 参数（如 top_k、stop_sequences、mcp_servers、context_management、container）会被忽略
MiniMax-M3 支持通过 Anthropic 兼容内容块输入图片和视频；M2.7、M2.5、M2.1 和 M2 系列仅支持文本与工具调用相关内容块

API 指引

文本

语音

视频

图片

音乐

文件

模型

快速开始

1. 安装 Anthropic SDK

2. 配置环境变量

3. 调用 API

4. 特别注意

支持的模型

兼容性说明

支持的参数

Thinking 控制

Messages 字段支持

示例代码

流式响应

注意事项

​快速开始

​1. 安装 Anthropic SDK

​2. 配置环境变量

​3. 调用 API

​4. 特别注意

​支持的模型

​兼容性说明

​支持的参数

​Thinking 控制

​Messages 字段支持

​示例代码

​流式响应

​注意事项

快速开始

1. 安装 Anthropic SDK

2. 配置环境变量

3. 调用 API

4. 特别注意

支持的模型

兼容性说明

支持的参数

Thinking 控制

Messages 字段支持

示例代码

流式响应

注意事项