客户端工具兼容矩阵
Doc status已发布Feature status已上线Last updated：2026-09-19
OpenAI Responses API 定义了多种客户端工具类型（tool_search、local_shell、custom 等）。本页列出各类型在不同接入协议下的兼容范围，以及哪些模型拥有原生 Responses API 上游。
Responses-native 模型
这些模型至少有一条供应商货源原生支持 Responses API。当请求被路由到这类货源时，服务端执行类工具（如 web_search、mcp、tool_search 的 server 变体）由上游直接承载；路由到其它货源时仍按下方矩阵处理。
responses_native只保证该模型至少存在一条原生 Responses 货源，具体这次调用会路由到哪条货源由平台决定，不代表这次调用一定走原生货源、不受下方矩阵限制。
哪些模型当前是 Responses-native，请查询模型目录接口（GET /api/v1/models，字段 responses_native）。
工具类型兼容矩阵
| 工具类型 | 路由到 Responses 货源时 | 路由到其它货源时 |
|---|---|---|
function | 支持 | 支持 |
custom（如 Codex 的 exec） | 支持 | 已适配（Gemini 货源整理中） |
local_shell | 支持 | 已适配 |
namespace（工具分组） | 支持（展开为平铺工具） | 同左 |
tool_search · execution:"client" | 支持 | 已适配（上线中） |
tool_search · 服务端检索 | 支持 | 不支持：返回 400，reason=server_executed |
shell（本地执行） / apply_patch | 支持 | 计划中：返回 400，reason=not_adapted |
computer / computer_use_preview | 支持 | 计划中（需工具结果多模态回传） |
mcp / web_search / file_search / code_interpreter / image_generation | 支持 | 不支持：返回 400，reason=server_executed |
状态以生产环境当前版本为准，随发布更新；被拒绝的请求会在错误信息里说明原因与可用的替代路径。