AF-02LIVE
Codex API
Codex とコーディングエージェントを専用 Base URL へ接続し、キー、Quota、利用量を ArcaneFlux で管理します。
- Endpoint
codex.arcaneflux.com/v1- Protocol
- Chat / SSE
- Metering
- Token based
01 / QUICKSTART
コーディングエージェントを接続
Codex 専用 Base URL と API キーを設定し、小さなタスクで認証と応答を確認します。始める前に
- Codex API を利用できるアカウント
- 用途別に発行した API キー
- 環境変数を設定できるクライアント環境
1. API キーを分ける
ローカル、CI、本番でキーを共有せず、それぞれに Quota と有効期限を設定します。
2. 接続情報を設定
Codex 専用 Base URL とキーを環境変数へ保存します。
export ARCANEFLUX_API_KEY="your_api_key"
export ARCANEFLUX_BASE_URL="https://codex.arcaneflux.com/v1"3. 小さなタスクで確認
クライアントを起動
設定した環境変数を読み込んだ新しいセッションを開始します。
読み取り中心のタスクを実行
小さなリポジトリ説明や差分レビューで応答を確認します。
利用記録を照合
API キー、時間帯、request ID、Token 利用量を確認します。
4. 運用前チェック
- timeout と再試行回数に上限を設ける
- CI 専用キーの権限と Quota を限定する
- request ID をログへ残す
- キーの失効とローテーション手順を決める
02 / OPERATIONS
Usage & quota
Token 利用量は API キーと期間から確認します。実装や障害調査では、Codex 専用 Base URL、対象キー、時間帯、request ID を同じ記録へ残します。
Limits & retry
| HTTP | code | Action |
|---|---|---|
| 429 | rate_limit_exceeded | Retry-After 後に再試行 |
| 429 | insufficient_quota | 残高またはプランを確認 |
03 / API REFERENCE
API Reference
Codex 専用エンドポイント、Bearer 認証、SSE、Models と障害時の扱いを確認します。Base URL & authentication
https://codex.arcaneflux.com/v1Authorization: Bearer $ARCANEFLUX_API_KEYEndpoints
| Method | Path | Purpose |
|---|---|---|
| POST | /chat/completions | コーディングエージェント向け応答、SSE 対応 |
| GET | /models | 利用可能なモデルを取得 |
Errors
| HTTP | code | Client action |
|---|---|---|
| 401 | invalid_api_key | キーと Authorization 形式を確認 |
| 403 | subscription_required | Codex API を開通 |
| 404 | unknown_product | Codex Base URL とパスを確認 |
| 502 | upstream_error | request ID を保存して再試行 |
| 504 | upstream_timeout | timeout と再試行上限を確認 |
04 / SUPPORT
Troubleshooting
認証、Rate limit、利用記録を同じ順序で切り分けます。認証エラーになる
キーの値、失効状態、有効期限、Codex のサービスグループを確認します。
Rate limit が返る
エラー code で QPS 超限と利用枠不足を分けます。
利用記録が見つからない
Codex 専用 Base URL、対象キー、時間範囲、request ID を確認します。
05 / RELEASE NOTES