Admin API（OpenAI API）

ユーザーの招待、監査ログの確認、プロジェクトの管理、API キーの管理、支出上限とアラート、データ保持、レート制限の運用といった作業を扱えます。ダッシュボードの外で動かしたいバックオフィスの自動化、セキュリティのワークフロー、運用ツールに使う位置づけです。

Admin API は、OpenAI API の組織の管理作業を自動化するための API です。主なエンドポイントには次のものがあります。

• Invites：メールアドレス宛てに組織への招待を送ります。
• Audit Logs：組織で最近行われたユーザーの操作と設定変更を一覧で取得します。
• Spend Limits：組織の月間の支出上限 (hard limit) を作成または置き換えます。

このほか、プロジェクトのモデル権限、支出アラート、データ保持の設定も扱えます。

Admin API キーは、管理用以外のエンドポイントには使えません。通常のモデル呼び出しには別の API キーを使う必要があります。対象プランについては、公式のリリースノートには記載がありません。

プロジェクトのモデル権限 (project model permissions) で、プロジェクトごとに使えるモデルを制限できます。

• mode を allow_list にすると、リストにあるモデルだけを許可します。
• mode を deny_list にすると、リストにあるモデルを禁止し、それ以外の利用可能なモデルは許可します。

指定するモデル ID は組織から見えるものである必要があります。組織から見える fine-tuned モデルのスナップショットも指定できます。

Spend Limits エンドポイントで、組織の月間の支出上限 (hard limit) を作成または置き換えます。金額は threshold_amount にセント単位で指定します。

追跡されている支出が上限に達すると、影響を受ける API リクエストは 429 エラーを返します。

プロジェクトの支出アラートは、プロジェクトの支出がしきい値に達したときにチームへ通知する機能です。しきい値の金額もセント単位で指定します。

プロジェクトのデータ保持設定 (project data retention controls) で、プロジェクトごとに組織の保持ポリシーを上書きするか、組織の設定を引き継ぐかを選べます。組織の設定を引き継ぐときは、retention_type を organization_default にします。

Admin API は Node、Python、Go、Ruby、Java 向けの OpenAI SDK で使えます。

1. Admin API のエンドポイントを使うために、Admin API key (Admin API キー) を作成します。
2. 環境変数 OPENAI_ADMIN_KEY を設定し、使う言語の SDK を初期化します。