資源群組與請求診斷

需要排查帳號忙碌、冷卻或會話路由時，再查這篇。只想看一次失敗調用，先看日常使用。

並發與會話綁定

當客戶端主動換成另一個模型、攜帶完整且不依賴上游狀態的歷史時，原帳號不支援新模型可重新選擇同一資源群組內符合條件的帳號；上游續接和同模型請求保持原綁定，詳見模型路由。容量、冷卻或帳號故障本身不會觸發自動換號。

新訂閱帳號預設允許 30 個同時執行的模型要求，可在「帳號 → 調度設定」調整為 1–1,000，升級保留已有帳號的設定。這是本地容量控制，不代表訂閱平台保證的並發能力。工作區總容量預設 128 個操作，包含等待請求和共享元資料讀取，可透過啟動組態調整。成員並發預設 10，可設為 0–1,000；0 表示不設成員並發限制。 HTTP、SSE、壓縮和 WebSocket 回合的帳號插槽保持到響應關閉。降低上限不會中斷已獲準請求。

對話空閒或 WebSocket 連線保持打開，但沒有正在執行的回合時，不佔模型請求槽位。回答結束後隨回應關閉釋放；客戶端取消 Codex 請求後，最多再讀取 3 秒以收集最終用量，然後釋放，仍受可設定的單次請求總逾時（預設 30 分鐘）和服務關閉約束。如果客戶端只是沒有繼續聊天，卻沒有取消仍在執行的請求，插槽會保留到該請求結束或逾時。

降低上限不會中斷已獲準請求。帳號滿載時，新請求最多等待 30 秒（預設），每個資源群組最多同時等待 100 個請求（預設）。插槽釋放或提高並發上限後，等待請求會重新嘗試准入。隊列滿返回 429 account_queue_full，等待超時返回 429 account_wait_timeout，均提供 Retry-After: 1。排隊和這些本地拒絕不會中斷正在輸出的請求，也不會增加上游帳號的失敗計數。

等待請求計入成員並發和工作區總限制，RPM 只計算一次；實際獲準前，不持有帳號槽位，也不暫佔額度。發送前會重新檢查資源群組權限、模型策略、成員狀態、金鑰啟用/撤銷/過期狀態、帳號健康、訂閱配額及個人額度。客戶端取消或服務關閉會及時移除等待請求。等待期間不持有准入鎖或資料庫事務；槽位釋放後，先記錄已完成請求的用量，再允許下一個請求進入。

冷卻仍返回 429 account_cooling 和 Retry-After，不進入隊列。已綁定的對話只等待原始帳號，不會因繁忙、冷卻或故障自動換帳號；無會話綁定或新會話可以直接選擇其他可用帳號。訂閱配額耗盡、成員/工作區限制和個人額度限制仍按原始規則生效。

沒有 Session_id 或非空 prompt_cache_key 的請求獨立選擇帳號，不建立會話綁定。新會話在支援模型的可用帳號間輪換。一個資料庫只運行一個 SubLane 程序。

訂閱帳號調度與額度範例（合成數值）：

冷卻與恢復

整個帳號的冷卻用於上游 429。優先遵守 Retry-After，範圍為 1–3600 秒；缺失或無效時使用可設定的回退時間，預設為 5 秒。憑證刷新失敗有獨立退避。請求逾時、HTTP 408 和原因未知的網路失敗不會使整個帳號冷卻。

明確的上游 5xx 與無效、異常中斷的回應流以「帳號 + 模型」累積。預設兩分鐘內三次邏輯失敗後，對此模型冷卻 10 秒，繼續失敗逐步延長，最多五分鐘。閾值、計數視窗和初始冷卻時間可設定；閾值設為 0 可關閉暫時失敗的模型冷卻。其他模型繼續可用。後續普通恢復請求成功後清理對應狀態，遲到的舊請求不能清除新失敗；Antigravity 的結構化模型限流仍按原有範圍恢復。

在收到成功回應之前，明確的 HTTP 408、500、502、503、504 可在原帳號上最多重試兩次，並使用有界退避。每次重試重新檢查成員、金鑰、資源群組與模型策略、配額、帳號狀態和內容規則。一個邏輯請求只持有一份插槽、請求 ID、歷史記錄和最終結算。上游要求較長等待時返回重試提示。原因未知的網路失敗、400/401/403/429、已接收的流和已輸出內容不會由此機制自動重播；原有明確 401 後的憑證刷新嘗試仍獨立處理。

HTTP SSE 預設每 10 秒發送註解心跳，同時繼續讀取上游事件。可選的流空閒超時只根據上游事件計時，下游心跳不會掩蓋模型停滯；預設為關閉。推理回應頭等待預設五分鐘，元資料保留較短逾時，單次請求與 WebSocket 回合的總逾時預設 30 分鐘。配置項見部署說明。

「清除冷卻」不會啟用帳號、更新授權或恢復訂閱配額。已有對話保留原帳號。帳號和模型冷卻持久化；升級會清理無法確定模型範圍的舊帳號級暫時失敗懲罰，實際限流保持不變。

憑證刷新與恢復

Codex 憑證在距離過期兩分鐘內按需刷新。如果刷新暫時失敗，只要舊訪問令牌仍有超過 30 秒的有效期，且未被上游拒絕，請求就可以繼續使用它；有效期會在刷新嘗試結束後重新檢查。 Claude 和 Antigravity 維持原有有效期限要求。

同一帳號共享刷新退避：依序等待 30 秒、1 分鐘、2 分鐘、4 分鐘，之後最多 5 分鐘。 OAuth 介面要求更長的 Retry-After 時會遵守，上限一小時。等待結束後，由後續憑證讀取或模型請求觸發重試，不新增後台輪詢；其他帳號各自獨立計時。

沒有可用令牌時，模型請求返回 503 account_refresh_failed 和 Retry-After。刷新失敗不會累計模型呼叫冷卻懲罰；刷新成功或重新授權後清除刷新退避。退避時間保存在進程內，上游拒絕記錄則隨憑證加密保存，重啟不會讓被拒絕的舊令牌重新獲得回退資格。

Codex 令牌介面只有返回 invalid_grant、refresh_token_reused 等明確憑證錯誤時，才會標記需要重新授權；未知的 HTTP 400/401、代理錯誤頁面或共用 OAuth 使用者端設定錯誤本身不會觸發該標記。刷新後的令牌仍被模型介面拒絕時，仍要求重新授權。恢復過程中已有對話繼續綁定原帳號。

配額感知

Codex、Claude 和 Antigravity 模型請求會觸發共用後台配額讀取，調度不等待這次網路呼叫。 Codex 和 Claude 只有在新鮮主訂閱限額明確耗盡時，才排除新選擇；Antigravity 只限制與請求原生模型精確匹配的額度，並識別 SDK 思考等級後綴，其他模型不受影響；未知、過期或已經重置的資料不被當成零配額。新鮮視窗最多 2 分鐘，可能被重置時間縮短。

綁定帳號或所要求的 Antigravity 模型額度耗盡時，返回 403 quota_exhausted，仍不遷移對話。快照過期或到達重置時間後重新檢查，不保證此時配額已恢復。 Claude 帳號可因主額度耗盡而被排除；Antigravity 的單一模型耗盡不影響其他模型或整個帳號。

請求記錄

「常規 → 請求」僅顯示本人記錄；「管理 → 全部請求」供管理員排查。可依結果、模型、金鑰、請求 ID 和時間篩選，管理員還能依成員與訂閱帳號篩選。每頁最多 50 條，保留最近 7 天且最多 5,000 條。

記錄包括耗時、結果、脫敏錯誤碼、上游 HTTP 狀態及上游報告的 token 數，不記錄提示詞、回應正文、原始錯誤、IP、憑證或會話標識。認證失敗、進入網關前的請求校驗失敗、全域存取拒絕與元資料查詢不計入模型呼叫記錄。

服務端生成 req_… 請求 ID，HTTP 返回 X-Request-ID，WebSocket 事件附帶 request_id。使用該 ID 對照客戶端報錯與服務端記錄。 HTTP 200 不一定表示流最終成功，應同時看結果欄位。

「首次輸出」是網關開始處理到首個非空白文字、推理或工具參數增量的時間，包含排隊與上游等待；不是瀏覽器渲染時間。缺失 token 數保持未知。快取命中率是快取輸入 token 佔全部輸入 token 的比例，不是命中快取的請求比例。

個人請求診斷範例（合成記錄）：

長期匯總與成員限額見 團隊用量與限額。

模型級限流

只有 Antigravity 傳回的結構化限流資訊中，錯誤域、原因和模型都與目前請求相符時，才會縮小到模型範圍。資訊不足的 429 繼續以整個帳號冷卻處理。模型限制在重新啟動後保留，並綁定目前帳號生命週期；重新授權、停用後啟用和手動清除冷卻會使舊狀態失效。

模型冷卻返回 429 model_cooling，上游原始模型限流返回 429 model_rate_limited，並保留有界重試提示。其他模型繼續可用，已有會話仍綁定原始帳號。冷卻結束後，同一模型最多讓一個正常請求嘗試恢復，不額外發送推理探測。舊請求或其他模型的成功不能清除新限流；寫入失敗時，當前程序仍保留限制，並記錄持久化失敗。

帳號卡片顯示受限模型數量，整個帳號仍可參與其他模型調度。在「調度設定 → 清除冷卻」中可以同時清除帳號和模型冷卻，不改變帳號啟用、授權和訂閱額度。上游 HTTP 403 顯示 upstream_forbidden，不會籠統提示需要重新授權。

Codex 自動審查

對於標記為 guardian 或 review 的 codex-auto-review 請求，一致的父執行緒中繼資料可用來優先選擇父對話的帳號，查找範圍限於同一認證使用者與資源群組。既有子會話綁定優先，候選帳號仍須通過模型能力、權限、訂閱配額、用量分配及容量檢查。父執行緒資訊缺失、衝突、不明確、過期或帳號不可用時，會回到正常排程，不變更父對話綁定；父對話與審查工作的會話及快取識別碼保持獨立。HTTP 與 WebSocket 路由已使用合成資料測試，真實 Codex 用戶端是否接受仍未驗證。

依剩餘額度調度新對話

選用 SUBLANE_GATEWAY_QUOTA_WEIGHTED=true，依最受限視窗的剩餘百分比分配輪替份額。僅在最高優先級候選均屬同一受支援供應商，且具備新鮮完整數值時生效；Antigravity 僅使用指定模型額度。未知、過期、不完整或混合供應商資料維持平均輪替。

預設關閉，修改後需重新啟動。既有對話、父對話帳號偏好、模型權限、分配額度及並行檢查仍優先。百分比僅為調度啟發式，不代表各訂閱方案可比較的絕對容量。