OpenAI Agents API 公测：网关运营商需要正视的新绕道路径

9 月 10 日，OpenAI 的 Agents API 进入公测阶段。公告主打的是开发者体验，托管 session、自动上下文压缩、环境配置。藏在文档深处的一条信息运营意义更大，这个 API 根本不走 /v1/chat/completions。

如果你的团队通过网关路由 AI 流量，那么当前这个网关对开发者发起的每一条 Agents API 调用都是盲的。

一个新命名空间，一条新路由路径

Agents API 挂在 client.beta.agents.sessions 这个完全独立的 SDK 命名空间下，与标准的 chat 或 Responses API 没有交集。每个请求都需要 OpenAI-Beta: agents=v1 这个 header，而且 API key 必须带有两个此前不存在的权限范围，分别是 api.agents.read 和 api.agents.write，再加上模型推理所需的 api.responses.write。

这对网关运营商有一个具体影响。绝大多数 AI 网关的工作方式是拦截发往 OpenAI 兼容端点的请求，也就是 /v1/chat/completions、/v1/responses 这类路径。Agents API 不使用这些路径。通过 client.beta.agents.sessions.create(...) 创建的 session 会直接打到 OpenAI 的托管 harness 基础设施，绕过你配置的 base URL。

一个开发者从直接调用 Responses API 切换到 Agents API 之后，会同时从你的用量仪表盘、支出追踪器和审计日志里消失，而且是悄无声息地。

一次 API 调用，三条账单流水

标准模型 API 调用产生一条账单事件，输入 token 加输出 token，按模型单价计费。Agents API 可以同时产生三条不同的费用流，每一条都有独立的计费规则。

• 模型推理，按所选模型的标准 API 单价计算（比如设置 model: "gpt-6-astra" 就按 GPT-6 Astra 的价格）
• 内置工具调用，网页搜索、代码执行、文件操作和 MCP 连接各自有独立的计费行，按 OpenAI 的标准工具定价
• 容器算力，当 environment.type 设为 openai_hosted 时，沙箱在模型和工具费用之外还要按分钟收容器费

一次 sessions.create() 调用可以同时积累这三类费用。月末对账时，模型 token 费用看起来正常，但容器费和工具费会单独出现，而且不带 session 任务描述，也不带发起人信息。

目前可行的规避方案是要求开发者使用自托管环境（environment.type: "self_hosted"），这样打到 OpenAI 的只剩模型推理费用，而底层模型调用可以通过你的网关走 base URL 路由。OpenAI 文档注明，自托管模式下可以选择 Blaxel、Cloudflare、Daytona、E2B、Modal、Vercel 等沙箱提供商。

三家主要厂商都已经绕开了 /v1/chat/completions

这不只是 OpenAI 的故事。Anthropic 在 2026 年 4 月推出 Managed Agents API 时，用的是自己的 beta header（managed-agents-2026-04-01）和独立的端点结构。Google 今年早些时候在同样独立的 API 层面发布了 Gemini Enterprise Workflow Agents。现在 OpenAI 也加入了进来。

三家的模式是一致的，都是一个专用的 session 或 workflow harness，管理状态、上下文和工具执行，而且刻意不走标准 completion 端点。路由上的影响也相同，如果你依赖拦截 /v1/chat/completions 或它的 OpenAI 兼容变体，你路由的是 2024 年的 API，不是 2027 年生产 agent 工作负载会走的那条路。

站在路由器的位置，可以同时看到这个趋势在三家厂商上同步发生。团队通过 TheRouter 使用 Claude Code 时，某种程度上已经在标准 completion 路径之外运转了。Claude Code 的网关集成路由的是底层 API 调用，但上面那一层 agent session 管理由厂商控制。Agents API 把这种分层明确化、深化了。

网关运营商今天需要做的几件事

几个当下就可以落地的决策。

API key 管理 方面，Agents API session 需要 api.agents.read 和 api.agents.write 权限范围。如果你在通过管理后台给团队成员发 key，需要决定是给现有 key 加这些权限范围，还是专门创建仅用于 Agents API 的 key。单独的 key 审计信号更清晰，代价是多了一套凭据要管。

环境策略 方面，在你无法拦截 Agents API 流量的这段时期，推动团队选择 environment.type: "self_hosted" 加自选沙箱提供商。该模式下，底层模型调用会走沙箱 OpenAI client 配置的 base URL，这是你进入路由链路的入口。

成本归因 方面，把 Agents API 的容器定价页面加进月度账单核对清单。容器费用不出现在模型 token 的同一行。跑多小时托管沙箱任务的团队，账单形态会和他们的 Responses API 用量明显不同。

监控范围 方面，OpenAI 标注了 OpenAI-Beta: agents=v1 的公测状态，意味着端点合约可以在没有标准废弃周期的情况下变化。把 OpenAI SDK changelog 和 API 参考纳入常规监控。

TheRouter 用户需要关注的点

对于已经通过 TheRouter 路由 OpenAI 流量的团队，现有的路由配置对 chat completions 和 Responses API 继续有效。Agents API 需要带有新权限范围的直接 OpenAI 凭据，目前无法透明代理。

跟踪 OpenAI API changelog，留意 Agents API 何时走出公测，以及是否会出现面向它的 OpenAI 兼容路由层。Anthropic 侧可以对应关注的是 9 月 10 日平台更新中随同发布的 ant beta:sessions connect 命令，它让 terminal 可以直接 attach 到 Managed Agents session。两家厂商都在构建让运营商在标准 API 事件流之外观测 agent session 的工具。

TheRouter 当前路由的实用参照，是所有通过 /v1/chat/completions、/v1/responses 或兼容端点流通的流量，包括模型推理、流式响应、fallback 和成本归因。任何厂商的 agent session harness 都需要自己的凭据体系和自己的可观测性策略。