客户端工具兼容矩阵

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/spus,字段 responses_native)。

工具类型兼容矩阵

工具类型路由到 Responses 货源时路由到其它货源时
function支持支持
custom(如 Codex 的 exec)支持已适配(Gemini 货源整理中)
local_shell支持已适配
namespace(工具分组)支持(展开为平铺工具)同左
tool_search · execution:"client"支持OpenAI/Anthropic 协议已适配(Gemini 未验)
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

状态以生产环境当前版本为准,随发布更新;被拒绝的请求会在错误信息里说明原因与可用的替代路径。

Anthropic 原生输出与思考参数

Messages 请求路由到 Anthropic 上游时,可以使用Anthropic 字段表列出的 output_config 和 thinking 形状。其它协议按各自支持范围填写。

看当前 Responses-native 模型 · 查找错误码