常見問題

Base URL 到底要不要帶 /v1？

• Codex 與 Codex++ Provider 通常填 https://codexapi.asia。
• OpenAI Python/Node SDK 與多數 OpenAI Compatible 用戶端通常填 https://codexapi.asia/v1。
• 最終請求路徑只出現一次 /v1 即可。

為什麼別人看得到模型，我看不到？

模型清單與 API Key 所屬群組有關。請使用自己的 Key 請求 /v1/models，不要以他人的截圖或軟體內建清單為準。

同一個 API Key 能給多個軟體使用嗎？

可以，但不建議長期共用。按裝置與用途拆分 Key，較容易限制額度、查看用量與單獨撤銷。

Fast / 1.5x 可以由用戶端強制開啟嗎？

用戶端可以請求 Fast 服務等級，但最終是否生效仍取決於閘道透傳、模型能力與上游帳號。存在設定項不代表目前請求一定使用 Fast。

串流和 WebSocket 哪一個比較好？

大多數聊天和程式開發用戶端使用 SSE 串流即可。只有用戶端明確支援 Responses WebSocket 時才選擇 WebSocket。

429 後應該立即持續重試嗎？

不要。讀取 Retry-After，使用含隨機抖動的指數退避，並設定最大重試次數。

為什麼生成圖片後只有一大段文字？

通常是 Base64 圖片資料。需要支援圖像結果的用戶端，或自行解碼 b64_json 儲存為 PNG/JPEG。

文件和實際模型不一致怎麼辦？

以 /v1/models 和控制台目前群組為準。文件描述協定與接入方式，動態模型清單由伺服器即時回傳。