OpenAI Agents API 实战：如何构建 AI Agent、部署到云端并计算 API 与服务器成本

OpenAI Agents API 在 2026 年 9 月 10 日进入公测。你选定模型、工具和运行环境，OpenAI 托管那套驱动 Codex 的编排。接口本身不加平台费。一张账单通常只有三行：模型 token、内置工具，以及你真的用了托管沙箱才出现的容器时长。任务若要跑 xcodebuild、模拟器或签名，Linux 沙箱做不到，还要另加一台不睡眠的 Mac。

今天是 DevDay（2026 年 9 月 29 日，旧金山）。下面的单价来自撰稿时打开的 定价页、GPT-6 Astra 模型页和 Agents API 公告。主题演讲若改价，以控制台和定价页为准。功能与入口的背景见 DevDay 前瞻与 GPT-6 Astra 功能与价格。

先把账单拆成三行

「Agent 很贵」常常是把四样东西加在了一起：旗舰模型、搜索、容器空转，以及一台只为 macOS 才租的机器。拆开之后，日常循环贵在模型档位，不贵在「有没有调用 Agents API」。

最小 Agent 怎么建

会话入口是 POST /v1/agents/sessions，请求头带 OpenAI-Beta: agents=v1。密钥需要 api.agents.read、api.agents.write，推理还要 api.responses.write。密钥放在发起请求的进程里。不要把 OPENAI_API_KEY 写进沙箱环境变量；PATH、CODEX_* 这类保留名会被拒绝。

curl --no-buffer --fail-with-body https://api.openai.com/v1/agents/sessions \
  -H "OpenAI-Beta: agents=v1" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": {
      "model": "gpt-6-sol",
      "instructions": "Write clean code, run it, and report the actual output."
    },
    "environment": { "type": "openai_hosted" },
    "input": "Create tree.py, print a readable tree of the current directory, run it, show the output.",
    "stream": true
  }'

默认先用 gpt-6-sol，不要一上来就把 gpt-6-astra 写进每条会话。验收标准只有一条：它写出文件、跑起来、把真实输出读回来。评测过的难例再升舱 Astra。子 Agent 打开之后，token 按每个 Agent 的上下文累加，不是「一条用户消息」的价格。

部署到云端的三种落点

「部署」在这里不是再包一层平台。它只回答两个问题：谁来调用 API，工具在哪台机器上跑。

openai_hosted：脚本和检查

托管沙箱是一台 Linux 工作区，带 Python、Node.js 和命令行，工作目录 /workspace。适合生成脚本、处理数据和做不依赖 Apple 工具链的仓库检查。网络可以按任务收紧，文档示例里常见先把访问关掉，跑通后再开。

常驻进程：谁来发请求

原型可以在你面前的笔记本上发这支 curl。合盖之后，长会话就断。生产上把调用放进不睡眠的进程：队列、webhook 或定时任务。这个进程可以很小，它不负责编译 iOS。自定义镜像、GPU 或私有网络走 self_hosted 或文档中的伙伴环境，不要硬拗托管沙箱。请求字段以开发者文档为准。

什么时候必须是 Mac

托管沙箱是 Linux。xcodebuild、iOS 模拟器、签名和 TestFlight 必须在 macOS。编排留在 Agents API，Apple 工具链留在 Cloud Mac：脚本和前端检查可以进沙箱，出包和签名走 Mac。

首页价格胶囊在撰稿日写着：M4 · 16GB / 256GB 月付起价 $101.7，M4 · 24GB / 512GB 月付起价 $200.3。日、周、月、季都可以选。短期验收用按天或按周，常驻构建再改月付。结算以套餐页为准，本文不把起价写成合同价。

API 成本怎么算

下表是短上下文、每百万 token、美元。输入超过 272K，整次请求走长上下文：输入和缓存约 2 倍，输出约 1.5 倍，不是只给超出的部分加价。Batch / Flex 约为标准价一半，Fast 约为 2 倍。缓存输入更低，缓存写入约为未缓存输入的 1.25 倍。

若路由还停在 GPT-5.6 Sol，9 月 20 日能对上的促销价是输入 $4、输出 $20，写到 11 月 21 日。那是另一行模型，不要和 gpt-6-sol 的 $2 / $10 加在一起。上线前再对一次定价页。

服务器成本怎么加

• 只在你坐在电脑前时调用。服务器是 $0。合盖即停，不能接过夜任务。
• 要 7×24 接 webhook，工具全在沙箱或纯 API。编排进程很轻。你已经有常开的机器，就不要为了 Agents API 再租一台 Mac。
• 要 macOS。加上 Cloud Mac。16GB 档首页起价约 $101.7 / 月。它替换不了 token，只替换「没有 Mac 就跑不了的那一步」。

一张可改数字的月账单

下面是工作表，不是报价。假设 22 个工作日、每天 40 次会话，共 880 次。每次短上下文、无缓存：输入 2 万 token，输出 4 千 token，外加 1 次 web search。输入合计 17.6M，输出合计 3.52M。

三组对照，都还没加上检索内容 token：

• Luna + 搜索 + 1 GB 只计 5 分钟：约 $19（3.52 + 8.80 + 6.60）。
• 混合模型 + 搜索 + 1 GB 整段 20 分钟：约 $134（98.56 + 8.80 + 26.40）。
• 上一行再加 16GB Cloud Mac 起价：约 $235（134 + 101.7）。Mac 拿掉，API 侧仍是约 $134。

换成你自己的量，只改三个数：会话次数、每次输入 token、每次输出 token。单价行要和定价页保持一致。880 次若变成 88 次，模型、搜索和容器都大约除以 10，Mac 的月租不变。

FAQ

Agents API 有平台费吗？

公测公告写的是没有。你付所选模型的 token、调用到的内置工具，以及用了 openai_hosted 才出现的容器时长。

日常该用哪一档模型？

默认放 gpt-6-sol 或 gpt-6-luna。同一套 880 次会话，全程 Astra 的模型行是 $352，九成 Sol、一成 Astra 是 $98.56。难例先用固定评测集比过，再升舱。

托管沙箱能跑 Xcode 吗？

不能。它是 Linux。签名、模拟器和 xcodebuild 留在 macOS。Cloud Mac 解决的是这一步，不替代 API 账单。

密钥放在哪里？

放在调用 API 的进程里，不要放进沙箱环境变量。公测不支持 Zero Data Retention，self_hosted 也不例外。

月账单怎么估？

用上面的 880 次做底，替换次数和 token。容器至少算 1 GB 与 4 GB 两列，并同时看 5 分钟下限和 20 分钟整段。DevDay 当天若改价，以定价页为准。

先跑通，再看发票上的三行

构建顺序是：最小会话、三行账单、最后才是要不要 Mac。默认模型留在 Sol 或 Luna，Astra 留给评测过的难例。Linux 沙箱接脚本，macOS 接出包。两台机器不要互相替代，两张账单也不要并成一个「Agent 月费」。

延伸阅读

• OpenAI DevDay 2026：GPT-6 Astra、Agents API 与 Codex
• GPT-6 Astra：功能、价格与 API