🔑 API 金鑰

API 金鑰是呼叫 API 的核心憑證，建立並管理每個金鑰的額度、模型、分組和安全來源限制。

左側導航點選「API 金鑰」，或直接訪問 /keys。頁面清晰展示金鑰名稱、掩碼金鑰、啟用狀態、額度使用進度與繫結分組，並支援關鍵字搜尋、複製、編輯、啟停和批次管理。在行操作選單中，還可直接複製連線配置，或一鍵將憑證傳送至受支援的桌面聊天客戶端中。

建立 API 金鑰

配置選項	詳細作用
名稱	自定義名稱，建議按使用場景或應用命名，便於賬單區分與統計。
分組	指定該金鑰訪問的渠道分組（如預設組、高速組或特定訂閱組）。
Auto 分組順序	僅在分組選擇 `auto` 時生效；可繼承系統預設分流順序，亦可自定義此金鑰的專屬優先順序。
跨分組重試開關	開啟後，當首選分組渠道遇故障或受限時，自動無縫跨組重試下一候選分組，保障呼叫高可用。
過期時間	設定金鑰失效時間，到期後自動拒絕後續請求，留空為永不過期。
數量	支援一次性批次建立多個金鑰（系統將自動附加隨機字尾）。
額度	為此金鑰分配獨立的消耗上限，防止單一金鑰過度消耗賬戶主餘額。
無限額度開關	開啟後不受獨立額度限制（但仍受賬戶整體餘額約束）。
模型限制	限定此金鑰僅能呼叫指定模型白名單，防止誤呼叫昂貴模型。
IP 白名單	逐行填寫允許發起請求的 IPv4/IPv6 或 CIDR 網段，留空為不限制來源。

API 金鑰等同於您的賬戶憑據。切勿將金鑰明文提交到公共 GitHub 倉庫、前端客戶端程式碼或公共聊天工具中；若懷疑洩露，請立即刪除並生成新金鑰。

在 API 金鑰列表中點選掩碼金鑰，按提示完成安全核驗後即可複製完整金鑰。

點選「複製連線資訊」可一鍵將 Base URL 與 API Key 組合為標準客戶端連線串；亦可點選目標聊天客戶端圖示，通過瀏覽器協議一鍵呼起本地客戶端並自動填充配置。

在列表中找到目標金鑰，點選「編輯」按鈕，可隨時調整其額度上限、模型白名單、過期時間或 IP 限制（修改配置不改變 API Key 本身）。