OpenAI 模型與群組

Codex Relay 的模型清單不是固定寫死。API Key 所屬群組、目前帳號池與管理員公開策略共同決定你能看到和呼叫哪些模型。

取得實際模型清單

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

請複製回傳物件中的 id。用戶端顯示的暱稱、舊設定或第三方軟體內建清單都不能取代此結果。

群組決定什麼

項目	影響
介面能力	Responses、Chat Completions、Embeddings 或 Images
可見模型	/v1/models 回傳哪些模型 ID
調度池	請求可使用哪些上游帳號
計費規則	模型倍率、訂閱或餘額扣費方式
並行與限流	同時請求數、RPM 與其他視窗限制

模型名稱與別名

模型名稱應原樣複製。管理員可將公開模型名映射至上游模型，但使用者端只需使用群組公開的名稱。

模型不存在時

先重新請求 /v1/models。若模型不在清單中，修改本機名稱沒有作用，需要更換群組或由管理員公開該模型。

模型與端點匹配

類型	常用端點	說明
OpenAI Responses	POST /v1/responses	Codex 與新式 OpenAI 用戶端優先使用
OpenAI Chat	POST /v1/chat/completions	通用聊天用戶端相容性較佳
OpenAI Embeddings	POST /v1/embeddings	向量化與檢索工作流程
OpenAI Images	POST /v1/images/generations	僅適用公開圖像模型的群組

容量與自動調度

同一公開模型背後可以有多個上游帳號。當所有相容帳號都繁忙、受限流或不可用時，可能回傳 429、503 或 Selected model is at capacity。

用戶端應保留串流連線、遵守 Retry-After，並對可重試錯誤使用含隨機抖動的指數退避。不要在極短時間內無限重試。