GPT-5.5 官方模型页 API 与工具配置

一句话结论

GPT-5.5 适合用 Responses API 连接搜索、文件、代码解释器、shell、电脑操作和 MCP 工具；部署时应固定 snapshot，并先用 medium reasoning effort 做成本/质量基线。

适用场景

• 适合的任务：代码 Agent、长上下文检索、需要网页/文件/代码工具的研究和知识工作。

• 不适合的任务：只需要图像输出或音频输出的任务；模型页列出的输出模态为文本。

• 适用的模型版本：gpt-5.5 与快照 gpt-5.5-2026-04-23。

• 适用的客户端、Agent 或 API：Responses API、Chat Completions、Codex；复杂工具链优先 Responses API。

• 推荐的推理档位和参数：none、low、medium、high、xhigh 均需按当前模型页核对；GPT-5.5 默认 medium。生产评估固定模型快照、reasoning.effort、text.verbosity 和工具版本。

可直接使用的内容

最小配置清单（填入自己的部署系统）：

model: gpt-5.5-2026-04-23
api: Responses
reasoning.effort: medium
input_modalities: text, image
output_modalities: text
context_window: 1,050,000 tokens
max_output_tokens: 128,000
knowledge_cutoff: 2025-12-01
tools: enable only the tools required by the task
acceptance: record output, tool calls, errors, latency, and token usage

API 工具选择工作流：

1. Define the outcome and allowed side effects.
2. Enable only the required Responses tools: web search, file search,
   code interpreter, hosted shell, apply patch, computer use, MCP, or tool search.
3. Describe each tool's trigger, inputs, side effects, retry safety, and errors.
4. Start at reasoning.effort=medium and run a representative evaluation.
5. Keep the model snapshot and tool versions fixed while comparing effort levels.

测试/工作流步骤

1. 在部署配置中写入 snapshot，不用无版本别名作为唯一复现标识。

2. 按任务权限启用工具；不需要联网、文件或电脑操作时不要开放对应工具。

3. 为每个工具写清调用条件、参数、可见副作用、错误格式和重试安全性。

4. 用相同输入分别评估 low、medium 和必要时 high，记录成功率、延迟、token、工具错误和人工修改量。

5. 若输入接近百万 token 上限，单独测量检索命中率、截断、reasoning token 和长上下文费用。

原始证据与数据

• 模型页列出 GPT-5.5 默认 reasoning 为最高档位/默认 medium 的 API 行为，支持 none、low、medium、high、xhigh。

• 上下文窗口为 1,050,000，最大输出为 128,000；知识截止日期为 2025-12-01。

• 输入模态为文本和图像，输出为文本；模型页列出 Responses 和 Chat Completions，并列出 Responses 可用的 web search、file search、image generation、code interpreter、hosted shell、apply patch、computer use、MCP 和 tool search 等工具。

• 价格以官方价格页为准；模型页对应的 GPT-5.5 价格为输入 $5/百万 token、输出 $30/百万 token，长上下文规则需部署前再次核对。

适用边界

• 工具“可用”不等于任务一定会调用；仍应通过工具描述和评测验证触发行为。

• 模型页的知识截止日期不替代联网检索；时效事实应使用受控搜索或用户提供的资料。

• 上下文窗口是上限，不是建议一次塞满；reasoning token、工具结果和多轮历史都会占用空间。

• 此配置不是安全授权清单；computer use、shell、apply patch 和 MCP 的权限必须按环境最小化。

来源摘录或观察（仅做合规短引）

模型页将 GPT-5.5 的推荐用途概括为 coding、tool-heavy agents、grounded assistants 和 long-context retrieval；生产环境仍需用自身 eval 验证。