OpenAI Agents API は 2026 年 9 月 10 日にパブリックベータへ入りました。選ぶのはモデル、ツール、実行環境です。Codex を動かしているハーネスは OpenAI がホストします。API 自体にプラットフォーム料金はありません。請求はたいてい三行です。モデルの token、組み込みツール、そしてホスト型サンドボックスを実際に使ったときだけのコンテナ時間です。xcodebuild、シミュレータ、署名が要る作業は Linux のサンドボックスではできません。その段には、スリープしない Mac が別途要ります。
今日は DevDay（2026 年 9 月 29 日、サンフランシスコ）です。以下の単価は、執筆時に開いていた 料金ページ、GPT-6 Astra のモデルページ、Agents API の発表の数字です。基調講演で価格が動いたら、コンソールと料金ページが優先です。機能の地図は DevDay プレビューと GPT-6 Astra の機能と価格にあります。
請求を三行に分ける
「Agent が高い」は、旗艦モデル、検索、コンテナの空転、macOS のためだけに借りたマシン、この四つを足していることが多いです。分けると、日常のループが高い理由は モデルの段であり、「Agents API を呼んだこと」ではありません。
| 行 | いつ出るか | 執筆時に見えた単価 |
|---|---|---|
| モデル token | 推論のたび | 短コンテキスト、100 万 token あたり、入力 / 出力：Luna $0.10 / $0.50、Sol $2 / $10、Astra $10 / $50 |
| 組み込みツール | 呼んだときだけ | Web search は約 $10 / 1,000 回。取得した本文は入力 token として別計 |
| コンテナ | environment.type が openai_hosted |
1 / 4 / 16 / 64 GB が約 $0.03 / $0.12 / $0.48 / $1.92、20 分ごと、コンテナごと。対象セッションは分単位、最低 5 分 |
| 自分のサーバー | 常駐プロセスか macOS が要る | Agents API にこの行はありません。トップの月額起点は約 $101.7（M4 16GB / 256GB）と $200.3（24GB / 512GB） |
セッション作成の公開例は openai_hosted と書くだけで、メモリ段はありません。料金ページはコンテナを四段で課金します。請求書が届くまで、1 GB と 4 GB を両方計算してください。最安行だけを予算にしないことです。
最小の 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 ごとのコンテキストで足されます。ユーザーメッセージ一本の値段ではありません。
ベータの文書は、Agents API が Zero Data Retention に非対応だと書いています。self_hosted に変えても ZDR にはなりません。コードやキーを社内網の外に出せないなら、セッションを作る前にデータ制御を読んでください。
クラウドへ置く三つの場所
ここでのデプロイは、別プラットフォームで包むことではありません。誰が API を呼ぶか、ツールはどのマシンで走るか、この二つだけです。
openai_hosted：スクリプトと検査
ホスト型サンドボックスは Linux の作業領域で、Python、Node.js、シェルがあります。作業ディレクトリは /workspace です。スクリプト生成、データ処理、Apple のツールチェーンを使わないリポジトリ検査に向きます。ネットワークはタスクごとに絞れます。文書の例では、まずアクセスを切り、通ってから開く書き方がよく出ます。
起きているプロセス
試作なら、目の前のノート PC からこの 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 コストの計算
表は短コンテキスト、100 万 token あたりの米ドルです。入力が 272K を超えると、リクエスト全体が長コンテキストになります。入力とキャッシュは約 2 倍、出力は約 1.5 倍で、はみ出した分だけが高くなるのではありません。Batch / Flex は標準の約半分、Fast は約 2 倍です。キャッシュ入力は安く、キャッシュ書き込みは未キャッシュ入力の約 1.25 倍です。
| 項目 | 入力 | キャッシュ入力 | キャッシュ書き込み | 出力 |
|---|---|---|---|---|
| gpt-6-luna · 短コンテキスト | $0.10 | $0.01 | $0.125 | $0.50 |
| gpt-6-sol · 短コンテキスト | $2 | $0.20 | $2.50 | $10 |
| gpt-6-astra · 短コンテキスト | $10 | $1 | $12.50 | $50 |
| gpt-6-astra · 長コンテキスト（>272K） | $20 | $2 | $25 | $75 |
| Web search | 約 $10 / 1,000 回。取得本文の入力 token は別 | |||
| コンテナ 1 / 4 / 16 / 64 GB | 20 分あたり $0.03 / $0.12 / $0.48 / $1.92（分課金のとき最低 5 分） | |||
経路がまだ GPT-5.6 Sol なら、9 月 20 日の文書に合っていたプロモーションは入力 $4、出力 $20 で、11 月 21 日までと書かれていました。別のモデル行です。gpt-6-sol の $2 / $10 と足さないでください。出す前にもう一度、料金ページを見てください。
サーバーコストの足し方
- 座っているあいだだけ呼ぶ。サーバーは $0 です。蓋を閉じれば止まり、夜間の仕事は受けられません。
- webhook を一日中受け、ツールはすべてサンドボックスか素の API。編成プロセスは軽いです。すでに起きているマシンがあるなら、Agents API のためだけに Mac を借りないでください。
- macOS が要る。Cloud Mac を足します。16GB のトップ起点は約 $101.7 / 月です。token の代わりにはなりません。Mac がないと走れない一段の代わりです。
二つの支払いは別のものです。Mac が起きていても、Astra の出力 token は 100 万あたり $50 のままです。Mac を日から月へ切り替える前に、既定モデルを Sol か Luna に下げてください。
数字を差し替えられる月次ワークシート
これは見積書ではなくワークシートです。営業日 22 日、1 日 40 セッション、合計 880 回とします。毎回、短コンテキスト、キャッシュなし、入力 2 万 token、出力 4 千 token、Web search 1 回です。入力合計 17.6M、出力合計 3.52M です。
| 項目 | Luna | Sol | Astra | Astra 10% + Sol 90% |
|---|---|---|---|---|
| モデル token | $3.52 | $70.40 | $352 | $98.56 |
| Web search（本文 token を除く） | $8.80 | |||
| サンドボックス 5 分 · 1 GB / 4 GB | $6.60 / $26.40 | |||
| サンドボックス 20 分 · 1 GB / 4 GB | $26.40 / $105.60 | |||
三つの対照です。取得した本文の 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 のままです。
自分の量に替えるときは、三つの数だけ変えます。セッション回数、1 回の入力 token、1 回の出力 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 の月額」一つにまとめないでください。
長い仕事は、起きているマシンへ
ノート PC は curl を通すためです。夜間の Agent ループと xcodebuild は、スリープしない Cloud Mac に置きます。ノート PC は diff と請求書を見るだけです。