OpenAI Agents API 實戰：如何建構 AI Agent、部署到雲端並計算 API 與伺服器成本

OpenAI Agents API 在 2026 年 9 月 10 日進入公測。你選定模型、工具和執行環境，OpenAI 託管那套驅動 Codex 的編排。API 本身不加平台費。一張帳單通常只有三行：模型 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