Skip to main content
M3 原生支持 Interleaved Thinking。它能够在每轮 Tool Use 前,根据环境或工具的返回 (Output) 进行思考,并决策下一步行动。 这种能力使其在长程、复杂任务中表现出色,并在 SWE、BrowseCamp、xBench 等 Code & Agent Benchmark 上达到了 SOTA 水平。 下面我们通过具体的案例,说明 M3 在 Tool Use 和 Interleaved Thinking 上的最佳实践,它的核心是:回传每一次模型 Response 的全部信息,尤其是其中的思考字段(thinking/reasoning_details)。

参数说明

请求参数说明

  • tools: 定义可调用的函数列表,包含函数名、描述和参数规范

响应参数说明

工具使用响应中的关键字段:
  • thinking/reasoning_details: 模型的思考(thinking)
  • text/content: 模型输出的文本
  • tool_calls: 模型决定调用工具
  • function.name: 被调用的工具名称
  • function.arguments: 工具调用参数(JSON 格式字符串)
  • id: 工具调用的唯一标识符

特别注意

在多轮 Function Call 对话中,必须将完整的模型返回(即 assistant 消息)添加到对话历史,以保持思维链的连续性: OpenAI SDK:
  • 将完整的 response_message 对象(包含 tool_calls 字段)添加到消息历史
    • 原生的OpenAI API 的 MiniMax-M3 模型 content 字段会包含 <think> 标签内容,需要完整保留
    • 在 Interleaved Thinking 友好格式中,通过启用额外的参数(reasoning_split=True),模型思考内容通过 reasoning_details 字段单独提供,同样需要完整保留
Anthropic SDK:
  • 将完整的 response.content(包含 thinking/text/tool_use 等所有块)添加到消息历史
  • response.content 是一个列表,包含多种类型的内容块,必须完整回传

请求示例

Anthropic SDK

配置环境变量

示例代码

代码输出结果如下:
返回结果

OpenAI SDK

配置环境变量

Interleaved Thinking 友好格式

通过OpenAI SDK调用 MiniMax-M3 时,传递额外的参数(reasoning_split=True),可获得更友好的输出格式,thinking内容将单独输出到reasoning_details字段中,开发者可以直接用于展示,无需手动从content字段中解析。
重要提醒:为了保证Interleaved Thinking的生效、模型思维链不被打断,包含reasoning_details在内完整response_message必须被保留在Message History中,在下一轮调用中,回传给模型。如此才能发挥模型的最佳性能!
请注意请求并解析API返回的函数send_messages的实现,和追加历史消息messages.append(response_message)操作:
代码输出结果如下:
返回结果

原生格式

由于OpenAI ChatCompletion API原生格式并不支持thinking返回与回传,因此模型的thinking以<think>reasoning_content</think>的形式注入到content字段中。开发者可以手动将其解析出来,用于展示。但我们强烈建议开发者使用Interleaved thinking友好格式。 extra_body={"reasoning_split": False} 的作用:
  • 思考内容嵌入 content:模型的推理内容以 <think> 标签包裹在 content 字段中
  • 需要手动解析:如果想单独展示推理内容,需要手动解析 <think> 标签
重要提醒:如果选用原生格式,请注意,在历史消息中,切勿修改content的内容,务必完整保留模型思考内容,即<think>reasoning_content</think>, 这样才能保证Interleaved Thinking生效,发挥模型的最佳性能!
代码输出结果如下:
返回结果

注意事项

如果在使用MiniMax模型过程中遇到任何问题:
  • 通过邮箱 Model@minimaxi.com 等官方渠道联系我们的技术支持团队
  • 在我们的 Github 仓库提交Issue

推荐阅读

在 AI 编程工具里使用 MiniMax-M3

具备代码理解能力,适用于代码助手等场景。

文本生成指南

支持通过 Anthropic 和 OpenAI 兼容接口进行文本生成调用

Anthropic API 兼容(推荐)

通过 Anthropic SDK 调用 MiniMax 模型

OpenAI API 兼容

通过 OpenAI SDK 调用 MiniMax 模型