帳戶與 API Key

API Key 用來識別呼叫者、群組、計費規則與並行限制。一個 Key 只能看到其所屬群組公開的模型。

建立 Key

1. 登入 Codex Relay 控制台。
2. 開啟 API Key 頁面並選擇 新增。
3. 填寫可辨識用途的名稱，例如 macbook-codex 或 server-bot。
4. 選擇群組。群組決定可見的 OpenAI 模型、倍率與調度池。
5. 如有需要，設定到期時間、額度或模型限制。
6. 建立後立即儲存完整 Key。

不要公開 API Key

不要把真實 Key 寫進網頁 JavaScript、Git 儲存庫、截圖或教學。本文所有範例皆使用 YOUR_API_KEY 預留文字。

驗證 Key

curl -i https://codexapi.asia/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

回傳 200 且包含模型清單，表示網域、TLS、Key 與群組均可使用。

驗證方式

場景	建議請求標頭
OpenAI SDK、Codex 與相容用戶端	Authorization: Bearer YOUR_API_KEY

不建議把 Key 放進查詢參數。日誌、瀏覽器歷史與代理層更容易記錄完整 URL。

多個用戶端如何分配

• Codex、OpenAI SDK、桌面用戶端與伺服器工作分別使用不同 Key。
• 測試環境與正式環境分別使用不同 Key。
• 臨時分享時建立低額度、短效期 Key，用完立即刪除。
• 發生異常用量時，只撤銷受影響的 Key。

餘額、訂閱與用量

控制台會顯示餘額、訂閱進度與呼叫記錄。請求是否能執行仍取決於 Key 狀態、使用者狀態、群組可用性、訂閱額度與並行限制。

Key 洩漏後的處理

1. 立即停用或刪除舊 Key。
2. 建立新 Key，僅更新受影響的用戶端。
3. 檢查呼叫記錄中的時間、模型、Token 與來源 IP。
4. 如有異常用量，提供請求 ID 給管理員，不要傳送完整 Key。