訂閱帳號與 API 渠道

Codex、Claude、Antigravity 和 Grok Build 皆支援 OAuth 授權和憑證 JSON 匯入。額度查詢支援 Codex、Claude、Antigravity 和 Grok 訂閱週期。訂閱帳號可重新授權、驗證、啟用並加入資源群組。 API 渠道在獨立頁面管理，不出現在訂閱帳號清單中。

API 通路接入

以工作空間管理員身分開啟 API 渠道 → 添加 API 渠道，進入獨立的 /channels/new 頁面。平台預設可依名稱、平台 ID 或預設網址搜尋，並顯示本機品牌圖示；選取後自動填入基礎網址和上游協定。選擇 自訂 可設定 Chat Completions、OpenAI Responses、Anthropic Messages 或 Gemini，協定和網路代理選擇器也支援搜尋。基礎網址依需求包含 /v1 或 /v1beta，不要附加生成端點、查詢參數或金鑰。Azure 需填入自己的資源網址，也支援本機 HTTP 服務。

儲存後驗證連線、查看模型，再加入資源群組、授予成員存取權並建立個人閘道金鑰。模型探索依平台與協定處理 OpenAI 清單、Anthropic/Gemini 分頁目錄、OpenCode inference 目錄及 Qwen 的獨立模型清單端點；Gemini 會排除不支援 generateContent 的模型。原生 ID（例如 openai/model）保留完整命名空間。

用戶端格式與上游協定獨立。固定版本 SDK 執行器與公開轉換器支援一般和串流回應，保留明確輸出上限及未完成狀態；工具與思考能力取決於上游及轉換路徑。/v1/responses/compact 僅支援 Codex 訂閱。OpenCode 使用依成員和資源群組隔離的穩定對話 ID，無狀態模型測試使用獨立 ID；免費模型與方案限制仍由 OpenCode 決定。

上游金鑰及平台、協定設定加密儲存。金鑰不會由渠道中繼資料傳回，也不進入 OAuth 更新或 SDK 憑據庫。更換 API 金鑰保留渠道身分、平台、協定、網址和既有對話；變更這些設定需建立另一個渠道。SubLane 統計請求與 Token，不查詢 API 餘額或訂閱額度。模擬測試不代表真實服務商驗收。

管理員端點 POST /api/channels 接受 name、api_key、base_url，以及選用的 proxy_id、platform、protocol；協定值為 openai、responses、anthropic、gemini。更換金鑰使用 PUT /api/channels/{id}/key，省略平台和協定會保留已儲存設定。舊渠道維持 Chat Completions，既有 OpenCode 網址會自動辨識。訂閱憑據匯入仍拒絕 API 金鑰；API 憑據 JSON 使用 provider: "openai"。

訂閱額度

Grok 讀取官方 Grok Build 使用者端的額度元資料介面（GET https://cli-chat-proxy.grok.com/v1/billing?format=credits），顯示訂閱使用比例及週/月重置週期。缺失用量保持未知；僅在沒有新版週期欄位時使用舊版訂閱額度總量計算比例。額外付費用量、儲值餘額和產品用量明細不會被當作獨立訂閱額度。

Claude 顯示 5 小時和每週用量視窗，以及服務商提供的其他具名視窗。Antigravity 依可見模型顯示剩餘額度比例和重設時間，預設顯示 3 項並優先列出額度較低的模型，展開後可查看所有可見模型。內部模型的額度不會出現在用量回應中，但會保留在記憶體和 SQLite 中供請求准入檢查，重新啟動後仍有效；單一內部模型耗盡不會阻擋其他模型。重設卡僅在 Codex 帳號顯示。

查詢只讀取服務商元資料，不發送推理請求。缺少的百分比或重置時間保持未知；成功快照在重啟後保留，刷新失敗時保留原始觀察值並標記過期。快照最多保持 2 分鐘新鮮度，接近重置時提前過期。額度展示不代表模型權限認證，也不保證請求成功。新鮮的主額度視窗用於 Codex 和 Claude 帳號選路；Antigravity 只限制與請求原生模型精確匹配的額度，並識別 SDK 思考等級後綴，單一模型耗盡不會影響其他模型或整個帳號。未知、過期、未來時間或已到重置時間的資料不表示額度耗盡。額度耗盡時，已有會話仍保留原始帳號綁定。

Codex 管理員可查看重設卡清單，優先使用最早到期的適用卡片，並選擇定時或額度耗盡時自動使用。自動模式預設關閉，與手動使用共用每日上限。

存取訂閱帳號

1. 以工作空間管理員身份打開 訂閱帳號 → 新增帳號，選擇訂閱服務商並輸入名稱。
2. 選擇瀏覽器授權或匯入憑證 JSON。 Codex、Claude 和 Antigravity 在服務商頁面完成登入後，把完整回呼地址貼回 SubLane。Grok 使用設備碼：在授權頁確認顯示的設備碼，SubLane 會自動完成接取。
3. 點選 驗證連接，再打開 模型 查看該帳號上報的模型目錄。
4. 將帳號加入資源群組，授予成員訪問權，並創建個人網關金鑰。

SubLane 不啟動本機回呼接收器，所以回呼頁面顯示連線錯誤是預期現象。複製完整地址，包括 code 和 state。授權狀態綁定管理員會話、只能使用一次，十分鐘後過期；Codex 和 Claude 使用 PKCE。

授權或匯入前可選擇工作空間網路代理。令牌交換、刷新、模型發現和執行使用該帳號的服務端出口；瀏覽器登入頁面使用瀏覽器本身的網路出口。

憑證導入與刷新

Codex 支援嵌套 token 或扁平憑證。 Claude、Antigravity 和 Grok 支援 CLIProxyAPI 匯出的扁平憑證 JSON，其中包含存取權杖、刷新令牌和帳號身分。官方 API Key、導入檔案中的端點和代理覆蓋配置均不被接受。 SubLane 不自動掃描本機憑證。

Grok 導入使用 type: "xai"，包含 OAuth 存取權杖、刷新令牌、expired 或 expires_at，以及 sub、id_token、account_id 或郵箱中的身份資訊。導入的端點、using_api 和 API Key 模式不能將訂閱請求切換為按量付費 API。 Grok Build 的實際存取權限取決於訂閱權益。設備碼授權最多有效十分鐘，取消或過期後不會因遲到的回應而保存帳號。

重新授權必須保持原上游帳號身分。 Claude 也會保存一個加密設備標識，在刷新、重新授權和重啟後保持穩定；舊記錄在供應商 IO 前補全該標識。明確的憑證失效要求重新授權，臨時令牌故障按有界退避重試，並遵守上游 Retry-After。

模型與客戶端協議

使用個人金鑰請求 GET /v1/models，選擇資源群組目錄傳回的原生模型 ID。目錄包含符合條件的 Codex、Claude、Antigravity 和 Grok 帳號；Grok 的內部服務商識別為 xai，客戶端使用目錄傳回的原生模型 ID。已有服務商前綴請求仍相容。帳號停用、繁忙或不可用時，已有會話仍保持原帳號綁定。

客戶端協議與訂閱供應商獨立。 OpenAI Responses、Chat Completions、Claude Messages 和 Gemini 格式透過固定版本的 SDK 適配器選擇可用帳號。 Responses 支持 WebSocket；/v1/responses/compact 僅限 Codex 帳號。模型特性取決於所選服務商與轉換路徑。

驗證邊界

自動化測試使用合成憑證和模擬上游。開放整合不等於所有真實訂閱與桌面使用者端工作流程均已認證；請為自己的帳號和使用者端單獨驗收。 SubLane 加密保存憑證，並與成員閘道金鑰分離。另見系統架構。