個人 API 金鑰

已經有登入帳號、並且管理員已授權資源群組，就可以從這裡開始。無需了解訂閱憑證或額度演算法。

建立並使用一把金鑰

登入後開啟“API 金鑰”，點選建立。
填寫容易辨認的名稱，選擇獲準使用的資源群組；有效期限按需設定。
複製金鑰，在客戶端填寫它、實例位址和池中可用的模型 ID。 Codex 使用者按客戶端配置操作。
發送一條訊息，並在「請求記錄」確認結果。

**完成標誌：**客戶端收到回覆。這把金鑰之後可以繼續使用，不需要另建額度方案。

沒有可選池時，請管理員檢查目前空間的資源群組直授。管理員首次接取時，應先建立資源群組。

選池清單會顯示每個池所包含的訂閱帳號數。空池也可提前建立金鑰，但加入訂閱帳號前無法發起請求；表單會提前提示。

接下來可查看日常用量。以下內容只在複製、換池、停用或接取其他工具時需要。

個人金鑰建立表單範例，不含真實金鑰：

已填写演示名称与資源群組的个人 API 密钥表单

生命週期

每人在每個工作空間最多保留 20 個未撤銷金鑰，暫停和過期的金鑰仍計入限制。預設啟用且不過期，可修改名稱、啟用狀態和過期時間。到期後需延長或移除截止時間才能恢復使用。

暫停可以恢復；撤銷不可恢復，並會刪除可恢復的加密金鑰值。資源群組綁定在建立後不可更改，換池請建立新金鑰、更新使用者端，再撤銷舊金鑰。停用成員會阻斷其在目前工作空間的金鑰，不影響其他工作空間；重新啟用後，未撤銷且仍有效的金鑰可以恢復使用。

每次請求與每個 WebSocket 新回合都會重新檢查金鑰、工作空間、成員、資源群組權限和模型策略。已經獲準的請求可能會繼續完成。最近使用時間記錄成功認證，不代表模型產生成功或計費量。

複製與備份

點擊複製按鈕後，服務端才讀取完整金鑰；此操作要求本人會話並記錄不含金鑰值的審計事件。剪貼簿寫入失敗時，可在臨時對話方塊中手動複製。關閉對話方塊或切換身分會清除臨時值。

新金鑰以 AES-256-GCM 加密儲存，網關認證使用 SHA-256 摘要。備份必須同時保存 SQLite 和 credentials.key；已有加密金鑰時，缺少或不符的加密檔案會阻止啟動。舊的僅摘要金鑰仍可認證，但無法複製原文，系統不會從後續請求擷取原文。保留相同專案名稱及資料卷。啟動時會初始化新資料庫，並為受支援的既有資料庫執行缺少的增量遷移；包含 001_settings.sql 的早期不相容預發布結構會被拒絕，應保留舊目錄後另建資料目錄。升級前先匯出並驗證備份；僅切換映像不能回復已遷移的資料。

可選：使用用量分配

建立金鑰時，清單會顯示目前工作空間可用的資源群組。使用用量分配時，選擇一個「用量分配：分配名稱 · 資源群組”選項即可，無需分別選擇分配和資源群組。表單會同時提交用量分配與專用池的綁定。同一成員綁定相同用量分配的多把金鑰共用額度；已有金鑰不會自動綁定新分配，未綁定該分配的金鑰不能使用其專用池。切換到另一項用量分配時，請新建金鑰並更新使用者端。

金鑰與登入帳號

管理員和成員都在「常規 → API 金鑰」管理自己的金鑰。網關位址使用實例網域加 /v1；客戶端填寫範例見 Codex 使用者端。

金鑰以 sl_ 開頭。清單只傳回名稱、前綴、狀態和時間等元資料。管理員也不能透過個人金鑰介面檢視或複製其他成員的金鑰。瀏覽器登入 Cookie 與網關金鑰互相獨立：Cookie 不能呼叫模型，API 金鑰不能存取管理介面。

導入 CC Switch

在瀏覽器所在電腦安裝 CC Switch，然後在有效且可複製的金鑰上選擇匯入：

選擇 Codex、OpenCode、Claude Code、OpenClaw、Hermes、Gemini CLI 或 Grok Build，檢查組態名稱、實例位址、資源群組，並選擇該池可用的模型。
點選「準備導入」，透過本人介面讀取金鑰。
點選「開啟 CC Switch」，在外部應用程式中檢查並確認配置。

導入參數已對照 CC Switch v3.20.4 的供應商深連結協定核對，請使用支援所選客戶端的 CC Switch 版本。

客戶端	API 基礎位址	協定
Codex、Grok Build	實例根位址 + `/v1`	Responses
OpenCode、OpenClaw、Hermes	實例根位址 + `/v1`	相容 OpenAI 的 Chat Completions
Claude Code	實例根位址	Claude Messages
Gemini CLI	實例根位址	Gemini 生成介面

Claude Code 的預設模型及 Haiku、Sonnet、Opus 別名皆對應到所選的資源群組模型。 Gemini CLI 使用 API 金鑰認證；SubLane 暫不提供 Gemini Token 計數和原生模型發現接口，導入後請驗證實際工作流程。 Grok Build 的導入配置使用 CC Switch 預設的上下文窗口，請按所選模型檢查。選擇使用者端不會改變已啟用的訂閱服務商。

包含完整金鑰的 ccswitch://v1/import 位址僅暫存在對話方塊內；它交給本機應用程式處理，不經過遠端轉機。關閉或修改設定會清除已準備好的連結；如需更換客戶端，點選「修改設定」後重新準備。開啟操作不能證明應用程式已安裝或匯入成功，導入也不自動切換目前配置。手動接入和 Gemini 範例仍可透過「接入指南」查看。

匯入 Magpie

在執行瀏覽器的電腦上安裝 Magpie 0.1.8 或更新版本。在「API 金鑰」中，選擇已啟用、未過期、可複製且有權存取所屬資源群組的金鑰，點選「匯入 Magpie」。核對閘道位址和金鑰名稱，點選「準備匯入」，再點選「開啟 Magpie」，並在 Magpie 內確認。模型會從金鑰所屬資源群組自動取得，無需手動選擇。

準備匯入與複製金鑰使用相同的僅限本人存取、附帶稽核的金鑰讀取介面。本機應用程式連結會將完整金鑰和連線資訊傳送給此裝置上的 Magpie。關閉視窗或切換身分會清除已準備的連結。SubLane 無法確認是否安裝 Magpie 或是否接受匯入，請在用戶端發出一次請求驗證。

接入 Cline

開啟「API 金鑰 → 存取指南 → Cline / OpenAI 相容」，然後在 Cline 設定中：

將 API Provider 設為 OpenAI Compatible。
填入指南中的 API 基礎位址，保留末尾 /v1。
在 API Key 中貼上個人 SubLane 金鑰，將 Model ID 設為金鑰資源群組中可用的模型。如果 Plan 與 Act 使用獨立配置，請分別設定。
發送一條訊息並在 SubLane“請求記錄”中檢查結果。可選的上下文視窗、模型能力等參數應與所選模型一致。

指南還提供可複製的 Chat Completions 請求，透過 SUBLANE_API_KEY 環境變數測試。開啟指南或複製範例均不會讀取金鑰原文。 Cline 在此透過手動設定接入，不屬於 CC Switch 快速匯入選單。

介面參考

介面	用途
`GET /api/keys?cursor=0`	分頁讀取本人金鑰元資料
`POST /api/keys`	創建，返回元資料與完整金鑰
`PATCH /api/keys/{id}`	提交 `name`、`enabled`、`expires_at`
`POST /api/keys/{id}/secret`	本人明確讀取完整金鑰，空 JSON 請求體
`POST /api/keys/{id}/revoke`	永久撤銷，空 JSON 請求體
`GET /api/keys/{id}/models`	讀取有效金鑰所屬組的模型

其他使用者或不存在的金鑰返回 404；不可複製的金鑰返回 409 api_key_not_copyable。網關拒絕無效、暫停、過期、撤銷的金鑰，或金鑰所屬工作空間、成員、資源群組不可用時，返回 401 invalid_api_key。