SubLaneSubLane

模型目錄

探索原生模型 ID,並管理目錄顯示狀態與路由權限。

模型列表為空,或需要限制可用模型時,再查這篇。首次使用只需選擇池中實際提供的模型,請參閱第一次使用。

查看模型

管理員在「訂閱帳號 → 模型」查看帳號上次回傳的模型與同步時間,在「資源群組 → 模型」查看資源群組的總結果。成員在「API 金鑰 → 模型」中查看自己的可用模型。客戶端調用 GET /v1/models,使用個人 Bearer 金鑰認證。

帳號、資源群組及金鑰目錄使用上游原生模型 ID,不另加服務商前綴。符合條件的 Codex、Claude、Antigravity、Grok Build 及相容 OpenAI 的 API 資源,依群組路由與備援策略參與目錄;公開目錄會過濾隱藏模型。相同可見 ID 合併顯示,多個服務商提供可見路由時以 sublane 作為 owned_by。思考變體使用發現的基礎模型判斷能力,權限檢查仍保留完整請求 ID。彙總目錄最多包含 4,096 個模型 ID。舊服務商前綴請求仍相容,明確前綴會縮小候選範圍。

模型目錄範例(模型 ID 為合成資料):

账号模型目录对话框,显示模型 ID 与更新时间

同步與有效期限

導入、OAuth 完成或重新授權後啟動發現。舊帳號在讀取目錄或首次要求時按需發現;重新授權會清除舊目錄。手動「驗證連線」和「刷新模型」使用同一發現機制。

快照在 15 分鐘內視為新鮮。過期讀取先傳回已有結果並觸發共用背景刷新;空閒時不周期輪詢。刷新失敗保留上次成功快照與時間,退避 30 秒;手動刷新有 5 秒冷卻。超過 24 小時的目錄仍供管理員查看,但不再用於公開目錄與路由。

成功取得的空清單表示已知不支援任何模型;沒有快照表示能力未知,兩者不同。單一帳號最多記錄 512 個模型 ID。最多同時執行兩項模型發現,並計入工作空間操作容量;預設容量為 128,可透過 SUBLANE_GATEWAY_CAPACITY 調整。

組目錄與推理

群組目錄是啟用且可用的訂閱帳號目錄並集,再套用 精確白名單。它不是第二份可編輯權限策略。停用、需要重新授權的帳號不參與目錄,未知帳號不會被當成支援全部模型。

路由先檢查具體帳號是否支援模型,再執行並發、冷卻與輪換規則。已知不支援返回 404 model_not_available;能力未知或過舊可能返回 503 model_catalog_unavailable。一個帳號發現失敗,不妨礙其他已知可用帳號提供服務。

現有對話保持帳號綁定。當客戶端主動更換模型、攜帶完整且可跨提供者重播的歷史時,如果原帳號不支援新模型,可在同一資源群組內選擇符合權限、配額與容量限制的帳號;原帳號支援新模型時繼續使用原帳號。同模型請求不會因模型目錄變更、冷卻、忙碌、停用或移除而自動換號。

上游續接請求保留帳號綁定。previous_response_id、儲存會話或訊息引用、加密推理/壓縮內容、Claude 思考簽章、Gemini 快取引用或簽章都不能觸發跨帳號切換。 WebSocket 增量回合不能更換模型;需要發送攜帶完整歷史的獨立 response.create。 HTTP 仍拒絕非空的 previous_response_id,需去掉該引用並提供完整輸入。無法繼續使用綁定帳號時回傳 conversation_account_unavailable。

升級透過增量遷移給已有綁定增加模型元資料。未記錄原始模型的舊綁定保持原始帳號,直到一次支援的請求補齊模型資訊;無法補齊時請新建會話。變更 Codex 版本策略 會觸發按需重新發現,不會改寫群組白名單。

介面

介面權限
GET /api/accounts/{id}/models管理員
GET /api/channels/{id}/models管理員
POST /api/accounts/{id}/models/refresh管理員,空 JSON 請求體
POST /api/channels/{id}/models/refresh管理員,空 JSON 請求體
GET /api/groups/{id}/models管理員
GET /api/keys/{id}/models有效金鑰的本人
GET /v1/models網關金鑰

個人結果不包含訂閱帳號身分或憑證。合成測試覆蓋目錄持久化、刷新競態與權限撤銷;發現介面本身不會探測模型產生。

模型可用狀態診斷

在資源群組或個人金鑰的模型彈跳窗中,點選模型或填寫原生模型 ID 後檢查狀態。結果顯示新請求的本地准入條件、排除原因、觀測時間和已知可重試時間。管理員可查看帳號級詳情;個人金鑰只回傳匯總,不揭露訂閱帳號身分。檢查不會傳送產生請求、刷新模型或額度、佔用插槽或建立會話綁定。未知和過期資料保留為未知。符合條件不保證上游產生成功;實際請求仍檢查金鑰、成員與用量分配限制,已有對話保持原帳號綁定。

手動檢測模型

管理員在「訂閱帳號」或「API 渠道」中開啟「模型」,點選模型旁的「檢測」。每次檢測會傳送真實生成請求、消耗上游額度並占用並行容量,30 秒後逾時。結果顯示此資源在檢測時是否成功、經過清理的錯誤及耗時(毫秒),不驗證個人金鑰的資源群組權限或用量分配。上方的本機可用狀態診斷不會傳送生成請求。

上游的顯示狀態與路由能力分開處理:隱藏模型不會出現在瀏覽器目錄或 GET /v1/models 中,但明確指定隱藏模型時,只要帳號支援且目前模型策略允許,仍可路由。隱藏模型同樣受權限、配額與容量限制。

內部模型的顯示與呼叫

Antigravity 標記為 isInternal 的模型,以及 Grok Build 標記為 hidden 或 _meta.hidden 的模型,仍可呼叫。登入後的帳號、資源群組及個人金鑰模型對話框會顯示它們,標示「隱藏模型」,排在可見模型之後,兩組各依字母排序;GET /v1/models 和 CC Switch 模型選擇器仍會過濾它們。明確請求仍執行模型策略、權限、配額、用量分配、容量、冷卻及帳號生命週期檢查。Grok 讀取已驗證的訂閱目錄,將選擇器別名正規化為原生路由 ID;舊目錄會自動更新以取得顯示中繼資料。