这几年大模型生意的主流卖法很清楚:你按 token 买「会说话的脑子」。接口形态是 Chat Completions、Responses——你问一句,模型答一句,中间的多步编排大多自己写。
2026 年 9 月 10 日,OpenAI 把另一层也做成正式产品:Agents API(智能体 API)公测。它卖的不是又一个聊天补全端点,而是托管版 Codex harness(干活架子):会话、编排、上下文压缩、恢复、子智能体分活,由 OpenAI 跑;你负责工具、知识和运行环境。
标题里说的「从卖模型 API 到卖 Agent API」,指的就是这一层上移:模型还能按 token 卖,但长跑智能体所需的「系统能力」也开始按标准 API 交付。

官网博文:Introducing the Agents API
先分清三件事
官方文档把「做智能体」拆成三条路,别混:
• Agents API:OpenAI 托管 Codex harness,适合长任务、要官方帮你管状态和恢复
• Agents SDK:编排循环跑在你自己的应用里,工具、审批、部署你说了算
• Responses API:直接打模型,自己从零搭智能体
这次发布的是第一条。SDK 和 Responses 还在;Agents API 是「把 Codex 那套云上干活能力,开成 beta API」。
谁先喊的
OpenAI 负责 API 方向的 Steve Coffey(X:@stevendcoffey,粉丝约 5400)发帖官宣。帖子约 97 万曝光。大意:上线 Agents API,用 Codex 架子在云上建智能体;工具、连接器、沙箱自带,然后让 Astra 去干。

Steve Coffey(OpenAI API)官宣帖
它到底是什么
四个核心概念:
• Agent:模型、指令、工具、MCP
• Environment:可选沙箱/机器,用来读写文件、跑命令、加载 skills
• Session:一次持久化的智能体实例,能跨多轮继续干活
• Events / items:你送进去的输入,和会话过程中吐出来的输出事件
调用形态是创建 session,不是发一条 chat message。HTTP 端点:
POST https://api.openai.com/v1/agents/sessions
请求头要带 OpenAI-Beta: agents=v1。SDK 走 client.beta.agents.sessions.create。平台密钥权限需要 api.agents.read / api.agents.write,推理还要 api.responses.write。
一次创建可以带上:模型(示例常用 gpt-6-astra)、instructions、tools(MCP / web_search / programmatic_tool_calling 等)、multi_agent、environment、input。之后还能往同一 session 续任务、中途 steer(纠偏)、用流式事件或 webhook 盯进度,用完可 delete session。
环境怎么选(三种)
文档写得很清楚,环境不是捆绑销售:
• type: none —— 不需要自己的算力/文件。适合问答、调远程 MCP/函数工具。这时内置 Bash、apply-patch、工作区文件都不可用
• type: openai_hosted —— OpenAI 托管沙箱(和 Codex / ChatGPT 同一套基建)。适合写代码、改文件、产出物
• type: self_hosted —— 跑在你自己的机器/VPC/合作方沙箱。你起环境、挂 executor,harness 下发命令你来执行
合作方包括 Blaxel、Cloudflare、Daytona、DigitalOcean、E2B、Modal、Oracle、Runloop、Vercel 等。Hypha 原声也点出一点:把「干活架子」和「沙箱」拆开,失败回复少了约 86%。

可选运行环境与生态合作方
架子里真正值钱的能力
• 长会话 compaction:快顶满上下文时自动压缩早期内容,跨多个窗口继续跑,不用自己写压缩逻辑
• tool search:工具多了按需加载定义,省 token、保住缓存
• programmatic tool calling:在代码里并行调工具、串步骤、过滤结果,只把有用的带回上下文
• 多智能体:拆子任务并行,子智能体各自上下文,主智能体汇总
• 恢复与续跑:session 存状态,断了可以接着干;可流式,也可 webhook
Quickstart 的最小例子很直白:openai_hosted 沙箱里让 gpt-6-astra 写 tree.py、跑起来、回报目录树——创建 session + stream 事件即可。
钱怎么算(别被「无额外费用」骗了)
博文说:Agents API 本身不加收一笔「架子费」。文档补了一句更实在的:
• 模型:按所选模型的 API 价
• OpenAI 工具:按工具标准价
• OpenAI 托管沙箱:按标准容器价(container rates)
所以「无额外 Agents API 费」≠ 免费。你省的是自建编排层;token、工具、托管沙箱照样付钱。架子核心逻辑来自开源 Codex harness,线上运维和升级由 OpenAI 做。
合规硬限制:目前数据驻留只支持美国;不支持 Zero Data Retention。就算 self_hosted 沙箱,Agents API 也不因此变成 ZDR 合规。
客户嘴里的数字
官网早期用户原声(自家说法,非统一测评):
• Ciridae:评测 0.71→0.85;子智能体流程延迟约降到 1/4
• SafetyKit:个案成本约降 60%
• Hypha:harness 与沙箱分离后,失败回复约少 86%
• Dwelly:高峰可甩出上百智能体异步跑
• Nash.ai:上千长跑智能体管物流;Agents API 管会话与编排,他们管接到真实世界的工具和环境
往后看
对看热闹的人:云上「能自己多步干活的 AI」有了官方标准接口,路径是 session,不是再堆一层 prompt 链。
对写产品的人:若你缺的是 Codex 那种托管编排,优先试 Agents API;若你要死磕审批流、私有部署和循环控制权,继续 Agents SDK。模型 API 不会消失,但战场确实在往上挪——谁把智能体跑稳、跑久、接进真实工作流,谁更像下一层平台。
链接
官网博文:https://openai.com/index/introducing-the-agents-api/
文档总览:https://developers.openai.com/api/docs/guides/agents-api/overview
架构说明:https://developers.openai.com/api/docs/guides/agents-api/architecture
Quickstart:https://developers.openai.com/api/docs/guides/agents-api/quickstart
三条路对比:https://developers.openai.com/api/docs/guides/agents
Steve 官宣:https://x.com/stevendcoffey/status/2098130889486274820
公测 · beta header agents=v1 · 无额外架子费但仍收 token/工具/容器 · 数据驻留仅美国 · 2026-09-10