OpenAI Agents APIとは — Codex harness採用の新エージェント基盤
2026年9月10日、OpenAIが「Agents API」をパブリックベータ公開した。Codex harnessをAPI化し、エージェントループ・セッション管理・サンドボックスをOpenAI側がマネージドで担う。料金構造と使い方、Agents SDK・Claude Managed Agentsとの違いを整理する。
OpenAIは2026年9月10日、「Agents API」をパブリックベータとして公開した。全開発者が利用可能で、Agents API自体に追加料金はなく、支払うのはトークン・ツール・コンテナ時間のみである。正体は、オープンソースのCodex用ハーネス（Codex harness）をOpenAIがホスト・保守する形でAPI化したマネージドサービスで、エージェントループの調整・セッションのオーケストレーション・コンテキスト管理・復旧までをOpenAI側が担う。開発者が決めるのは、エージェントに与える能力（ツール等）とコードの実行場所だけだ。本記事ではその中身・料金・使い方・既存サービスとの違いを整理する。
OpenAI Agents APIとは
Agents APIは、Codex harnessが持つ「モデル呼び出しとツール実行を調整するループ」をそのままAPI経由で使えるようにしたものである。開発者が自前でエージェントループを書く必要がなく、OpenAIがループの継続・セッションの永続化・コンテキストの管理・エラー時の復旧を代行する。中核となるのは以下の4つの概念である。
| 概念 | 内容 |
|---|---|
| Agent | モデル・instructions・tools・MCPサーバの組み合わせ |
| Environment | 任意のサンドボックス。ファイル操作・コマンド実行が可能 |
| Session | タスクを継続的にこなす永続的なエージェントインスタンス。ターンをまたいで状態を保持し、不要になれば削除できる |
| Events and items | セッションの入出力（進捗イベントと生成物） |
何ができるか
- コンテキスト自動コンパクション: セッションが上限に近づくと古い文脈を自動で圧縮する
- tool search: ツール定義をオンデマンドで読み込み、常時ロードに比べてトークンを節約する
- programmatic tool calling: ツールの並列実行や操作の連鎖をプログラム的に扱える
- subagents: 独立したコンテキストを持つマルチエージェント構成。サブエージェントを並行実行できる
- MCPサーバ・カスタム関数・Web検索をツールとして接続できる
- ストリーミングまたはWebhookで進捗を受け取り、同じセッションに追加のタスクを送って継続できる
料金
Agents API自体の利用料はなく、課金対象はモデルのトークン代とコンテナ（サンドボックス）の稼働時間である。公式サンプルで使われているgpt-6-astraの単価は次の通り（1Mトークンあたり、公式pricingページ記載）。
| 項目 | 短コンテキスト | 長コンテキスト |
|---|---|---|
| 入力 | $10 | $20 |
| キャッシュ入力 | $1 | $2 |
| 出力 | $50 | $75 |
コンテナ料金はHosted ShellやCode Interpreterと共通の体系で、1コンテナ・20分セッションあたり以下の通り分単位課金され、1セッションの最低利用時間は5分である。
| コンテナサイズ | 20分セッションあたりの料金 |
|---|---|
| 1GB | $0.03 |
| 4GB | $0.12 |
| 16GB | $0.48 |
| 64GB | $1.92 |
試算例: 16GBコンテナを1時間（20分セッション換算で3回分）使う場合、コンテナ料金だけで $0.48 × 3 = $1.44 となる。これにgpt-6-astraのトークン代が加算される（例えば短コンテキストで入力10万トークン・出力5万トークンなら、入力$1.0＋出力$2.5で追加$3.5程度）。実際のコストはツール呼び出し回数やコンテキスト長で変動するため、コミュニティでも「コンテナ起動数とコストを事前に試算すべき」との注意喚起がある。正確な料金は公式pricingページで要確認。
使い方（最短手順）
1. OpenAIのAPIキーを用意する
2. SDKを最新版に更新する（Python/JS/Goに対応）
3. POST /v1/agents/sessions でセッションを作成する（Agent定義とinputを渡す）
4. ストリーミングまたはWebhookで進捗（Events and items）を受け取る
5. 追加の指示が必要な場合は、同じセッションにタスクを送って継続する
# Python 最小例
from openai import OpenAI
client = OpenAI()
session = client.beta.agents.sessions.create(
agent={"model": "gpt-6-astra", "instructions": "..."},
input=[{"role": "user", "content": [{"type": "input_text", "text": "..."}]}]
)// JavaScript 最小例
const client = new OpenAI();
const session = await client.beta.agents.sessions.create({
agent: { model: "gpt-6-astra", instructions: "..." },
input: [{ role: "user", content: [{ type: "input_text", text: "..." }] }],
});コード実行を伴うタスクを組む場合は、事前に GPT-6 Astraの料金・ベンチマーク解説 でモデル単価とコンテキスト長の挙動を押さえておくと、コスト試算がしやすい。
サンドボックスの選び方
Environmentのtypeには openai_hosted（既定）と self_hosted の2種類があり、加えてパートナー企業のファーストクラス統合サンドボックスを選べる。
| 種別 | 特徴 |
|---|---|
| openai_hosted | OpenAI管理のサンドボックス（既定）。コード実行・ファイル操作・成果物生成に対応。ファイル投入・パッケージインストール・skills/plugins追加が可能 |
| self_hosted | 自前インフラで実行。codex exec-server を使い、WebSocketのアウトバウンド接続のみで接続する |
| パートナーサンドボックス | Blaxel, Cloudflare, Daytona, DigitalOcean, E2B, Modal, Oracle Cloud, Runloop, Vercelがファーストクラス統合。CPU/GPU/メモリ構成、VPCデプロイ、ファイル・シークレット保管などを選択できる |
自前でCodexハーネスを触ったことがある開発者は、OpenAI Codex入門ガイド でCodexそのものの基本操作を確認しておくと、Agents APIとの対応関係がつかみやすい。
Agents SDK・Responses API・Claude Managed Agentsとの違い
| サービス | 提供元 | 特徴 |
|---|---|---|
| Agents API | OpenAI | エージェントループ・セッション・サンドボックスまでOpenAI側がマネージド。Codex harnessをAPI化 |
| Agents SDK | OpenAI | 自分のアプリ内でオーケストレーションを動かすライブラリ。2026年4月にサンドボックス対応とmodel-native harnessを追加 |
| Responses API | OpenAI | 会話履歴やツールループを自分で管理する低レベルAPI |
| Claude Managed Agents | Anthropic | Anthropic API上でサーバサイドエージェントをホスト。セッションごとのコンテナ、ボールト保管のシークレット、SSEストリーミング、MCPネイティブ対応。Claudeモデル専用 |
どのツールを使うか迷う場合は、コーディングエージェント同士の比較として Codex vs Claude Code vs Cursor vs Copilot 比較 も参考になる。Agents APIはハーネス自体の管理をOpenAIに委ねたい場合に適しており、自分でオーケストレーションを組みたい場合はAgents SDKやResponses APIが選択肢になる。
注意点（ベータ・データ所在地・ZDR・コスト）
- パブリックベータの段階であり、仕様が変更される可能性がある
- データレジデンシーは米国のみに限定される
- Zero Data Retention（ZDR）には対応していない。self_hostedサンドボックスを使ってもZDR対象にはならない
- コンテナはセッション単位・分単位で課金され、最低5分から発生する。起動数を把握しないとコストが積み上がりやすい
- 詳細な仕様や最新情報は公式ドキュメントで要確認
よくある質問
OpenAI Agents APIとは何ですか。
OpenAIがホスト・保守するCodex harnessをAPI化したマネージドサービスです。エージェントループの調整・セッションのオーケストレーション・コンテキスト管理・復旧をOpenAI側が担い、開発者はツールなどの能力とコード実行場所を決めるだけで済みます。2026年9月10日にパブリックベータとして公開されました。
Agents APIの料金はいくらですか。
Agents API自体に追加料金はありません。課金対象はモデルのトークン代（gpt-6-astraは短コンテキストで入力$10・出力$50、1Mトークンあたり）と、サンドボックス用コンテナの稼働時間（16GBで20分セッションあたり$0.48など）です。
Agents APIとAgents SDKの違いは何ですか。
Agents SDKは自分のアプリ内でエージェントのオーケストレーションを動かすためのライブラリです。一方Agents APIは、エージェントループ・セッション管理・サンドボックスの運用までOpenAI側がマネージドで担う点が異なります。
self_hostedサンドボックスを使えばZero Data Retentionになりますか。
なりません。self_hostedサンドボックスを使用してもZDR（Zero Data Retention）の対象にはならないと明記されています。
どのモデルで使えますか。
ファクトシートではgpt-6-astraでの利用例が示されています。対応モデルの全リストは公式ドキュメントで要確認です。
まとめ
OpenAI Agents APIは、Codex harnessが担ってきたエージェントループやセッション管理をAPI経由でそのまま使えるようにしたマネージドサービスである。API自体への追加料金はなく、コストはトークンとコンテナ稼働時間で決まる。openai_hosted・self_hosted・パートナーサンドボックスから実行環境を選べる柔軟さがある一方、パブリックベータ段階であること、データレジデンシーが米国限定であること、ZDR非対応であることは導入前に押さえておきたい。自前でオーケストレーションを組みたい場合はAgents SDKやResponses APIとの使い分けを検討するとよい。
お気軽にご相談ください
お問い合わせ