服务端工具（Server Tools）

什么是服务端工具

服务端工具（Server Tools） 是由 MiniMax 在服务端托管并自动执行的内置工具。与传统的 Function Call（客户端工具）不同，你无需自行实现工具的执行逻辑，也无需在多轮对话中手动回传工具结果——模型在生成回复的过程中会自动调用这些工具、获取结果并继续生成，整个流程在一次 API 请求内完成。

该能力目前处于 Beta 阶段，功能与参数可能会调整。

客户端工具（Function Call）

模型返回 tool_use，由你的代码执行，再把 tool_result 回传给模型。需要多轮交互。

模型在 MiniMax 服务端自动执行工具并获取结果，一次请求内完成，你只需读取最终回复。

支持范围

能力	支持状态
接口	Anthropic Messages API（`/anthropic/v1/messages`） OpenAI Responses API（`/v1/responses`）
可用工具	`web_search`（联网搜索）
调用方式	在请求的 `tools` 数组中声明服务端工具

web_search

web_search 让模型在生成回复时自动进行联网搜索，获取实时信息，并基于搜索结果作答。适用于时效性强、需要最新事实的问题（如新闻、行情、文档查询等）。

声明工具

根据接口格式在 tools 数组中声明 web_search：

Anthropic Messages API
OpenAI Responses API

{
  "type": "web_search_20250305",
  "name": "web_search"
}

{
  "type": "web_search"
}

Anthropic Messages API 使用版本化类型标识 web_search_20250305；OpenAI Responses API 使用工具类型 web_search。请根据所调用的接口选择对应格式。

调用示例

Anthropic Messages API
OpenAI Responses API

cURL

curl https://api.minimax.cn/anthropic/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: ${MINIMAX_API_KEY}" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "MiniMax-M3",
    "max_tokens": 8192,
    "messages": [
      {
        "role": "user",
        "content": "帮我搜一下今天上海的天气"
      }
    ],
    "tools": [
      {
        "type": "web_search_20250305",
        "name": "web_search"
      }
    ]
  }'

cURL

curl --location 'https://api.minimax.cn/v1/responses' \
  --header "Authorization: Bearer ${MINIMAX_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-M3",
    "input": "帮我搜一下今天上海的天气",
    "tools": [
      {
        "type": "web_search"
      }
    ]
  }'

响应说明

Anthropic Messages API

启用 web_search 后，模型会在服务端自动执行搜索并将结果用于生成最终回复。你无需处理 tool_use / tool_result 的多轮回传，直接读取 message.content 中的 text 内容块即可获取答案。 message.content 会按模型的执行顺序返回多个内容块，一次完整的搜索问答通常包含以下类型：

内容块类型	说明
`text`	模型生成的文本。搜索前的引导语与搜索后的最终答案都属于此类型
`server_tool_use`	模型在服务端发起的工具调用，`name` 为 `web_search`，`input.query` 为实际检索的关键词
`web_search_tool_result`	服务端返回的搜索结果，`content` 为 `web_search_result` 列表，含 `title`、`url`、`page_age`、`content` 等字段

完整响应示例

{
    "id": "069d492820d3562155e88b67fe988b42",
    "type": "message",
    "role": "assistant",
    "model": "MiniMax-M3",
    "content": [
        {
            "text": "我来帮您搜索今天上海的天气信息。",
            "type": "text"
        },
        {
            "type": "server_tool_use",
            "id": "call_function_aa733q961ql2_1",
            "name": "web_search",
            "input": {
                "query": "今天上海天气"
            }
        },
        {
            "type": "web_search_tool_result",
            "tool_use_id": "call_function_aa733q961ql2_1",
            "content": [
                /// ...
                {
                    "type": "web_search_result",
                    "title": "上海天气预报",
                    "url": "http://www.weather.com.cn/textFC/shanghai.shtml",
                    "page_age": "2026-07-07 18:00:00",
                    "content": "地图版国内城市天气预报 天气预报 >国内> 上海 上海 今天周二(7月7日) 周三(7月8日) 周四(7月9日) 周五(7月10日) 周六(7月11日) 周日(7月12日) 周一(7月13日) 市 区/县 周二(7月7日)白天 周二(7月7日)夜间 天气现象 风向风力 最高气温 天气现象 风向风力 最低气温 上海 上海 - - - - 小雨 南风 <3级 28 详情 闵行 - - - - 小雨 "
                },
                /// ...
            ]
        },
        {
            "text": "根据最新搜索到的信息，今天（7月8日）上海的天气情况如下：\n\n## 🌤️ 上海今日天气\n\n- **天气**：多云到阴为主，局部地区有**短时阵雨或雷雨**\n- **气温**：早间最低气温约 30.3℃，白天最高气温可达 **35~36℃**\n- **风力**：南到西南风 3~4 级（沿江沿海地区 4~5 级），夜里转南到东南风\n- **湿度**：相对湿度 95%~60%，**体感闷热**\n- **预警**：上海市气象台已发布**中心城区高温黄色预警**\n\n## ⚠️ 温馨提示\n\n1. **防暑降温**：气温高、湿度大，闷热感明显，外出注意防晒、多补水。\n2. **防雨防雷**：局部有短时雷阵雨，建议随身带把伞，遮阳又挡雨。\n3. **台风消息**：今年第 14 号台风\"**巴威**\"强度超强，预计 11-13 日将对上海及周边海域产生明显的风雨影响，建议持续关注后续预报。\n\n## 📅 未来几天\n\n- **明天（7月9日）**：多云到阴，局部短时雷雨，气温 28~34℃，略有缓解\n- **周五起**：受台风\"巴威\"外流环流影响，多阵雨天气，气温下降并伴东南大风\n\n如需更详细的逐小时预报，可以访问 [中国天气网-上海](http://www.weather.com.cn/weather/101020100.shtml) 查询。",
            "type": "text"
        }
    ],
    "usage": {
        "input_tokens": 3206,
        "output_tokens": 365,
        "cache_creation_input_tokens": 0,
        "cache_read_input_tokens": 228,
        "service_tier": "standard"
    },
    "stop_reason": "end_turn",
    "base_resp": {
        "status_code": 0,
        "status_msg": ""
    }
}

OpenAI Responses API

启用 web_search 后，服务端会在一次请求内完成搜索和回复生成，无需回传工具结果。响应的 output 数组包含搜索调用和模型回复，直接读取顶层 output_text 即可获取最终答案。

字段或输出项	说明
`web_search_call`	服务端执行的联网搜索调用，包含调用 ID、执行状态和 `action.query` 实际检索词
`message`	模型生成的最终回复，文本位于 `content` 中
`output_text`	聚合后的最终文本，可直接读取

Responses API 响应示例

{
  "id": "06dde8fff7573ca7ba181eecab350bd5",
  "object": "response",
  "created_at": 1787737599,
  "status": "completed",
  "model": "MiniMax-M3",
  "output": [
    {
      "id": "call_function_1bto13bpgmku_1",
      "type": "web_search_call",
      "status": "completed",
      "action": {
        "type": "search",
        "query": "今天上海天气"
      }
    },
    {
      "id": "06dde8fff7573ca7ba181eecab350bd5_msg",
      "type": "message",
      "status": "completed",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "# 今日上海天气 🌤️\n\n根据搜索到的天气预报信息……",
          "annotations": [
            {
              "type": "url_citation",
              "title": "上海目前天氣",
              "url": "https://weather.yahoo.com/zh-hant-tw/cn/%E4%B8%8A%E6%B5%B7/",
              "start_index": 0,
              "end_index": 0,
              "content": "上海目前天氣……"
            }
          ]
        }
      ]
    }
  ],
  "output_text": "# 今日上海天气 🌤️\n\n根据搜索到的天气预报信息……",
  "usage": {
    "input_tokens": 12036,
    "output_tokens": 412,
    "total_tokens": 12448,
    "input_tokens_details": {
      "cached_tokens": 348
    }
  },
  "error": null
}

搜索行为完全在服务端完成，因此单次请求的耗时可能比不启用工具时更长，请合理设置客户端超时时间。

注意事项

服务端工具处于 Beta 阶段，行为与参数可能随时调整。
目前服务端工具仅提供 web_search，支持通过 Anthropic Messages API 和 OpenAI Responses API 调用。
Anthropic Messages API 的 Base URL 为 https://api.minimax.cn/anthropic；OpenAI Responses API 的端点为 https://api.minimax.cn/v1/responses。接口详情分别参见 Anthropic SDK 和 Responses API。

如在使用过程中遇到问题，可通过邮箱 Model@minimaxi.com 联系我们的技术支持团队。

开始使用

使用指南

常见问题

条款与政策

服务端工具（Server Tools）

什么是服务端工具

客户端工具（Function Call）