个人 API 密钥

先创建个人密钥并连接客户端，再按需查阅有效期、复制与接口说明。

已经有登录账号、并且管理员已授权资源组，就可以从这里开始。无需了解订阅凭据或额度算法。

创建并使用一把密钥

登录后打开「API 密钥」，点击创建。
填写容易辨认的名称，选择获准使用的资源组；有效期按需设置。
复制密钥，在客户端填写它、实例地址和池中可用的模型 ID。Codex 用户按客户端配置操作。
发送一条消息，并在「请求记录」确认结果。

**完成标志：**客户端收到回复。这把密钥之后可以继续使用，不需要另建额度方案。

没有可选池时，请管理员检查当前空间的资源组直授。管理员首次接入时，应先创建资源组。

选池列表会显示每个池包含的订阅账号数。空池也可提前创建密钥，但加入订阅账号前无法发起请求；表单会提前提示。

接下来可查看日常用量。以下内容只在复制、换池、停用或接入其他工具时需要。

个人密钥创建表单示例，不含真实密钥：

已填写演示名称与资源组的个人 API 密钥表单

生命周期

每人在每个工作空间最多保留 20 个未撤销密钥，暂停和过期的密钥仍计入限制。默认启用且不过期，可修改名称、启用状态和过期时间。到期后需延长或移除截止时间才能恢复使用。

暂停可以恢复；撤销不可恢复，并会删除可恢复的加密密钥值。在密钥的资源组旁点击双向箭头图标（更换资源组），可切换到当前工作空间内本人有权使用的资源组，密钥值及客户端配置保持不变。目标资源组有用量分配时会同步绑定。历史用量保留在原资源组；切换后请开启新对话，已有 WebSocket 连接的后续回合会被拒绝。更换资源组不会重新启用已暂停密钥或延长过期时间。停用成员会阻断其在当前工作空间的密钥，不影响其他工作空间；重新启用后，未撤销且仍有效的密钥可以恢复使用。

每次请求与每个 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 请求体
`PUT /api/keys/{id}/group`	提交当前空间内本人可用的 `group_id`，保留原密钥并同步绑定目标方案
`POST /api/keys/{id}/revoke`	永久撤销，空 JSON 请求体
`GET /api/keys/{id}/models`	读取有效密钥所属组的模型

其他用户或不存在的密钥返回 404；不可复制的密钥返回 409 api_key_not_copyable。网关拒绝无效、暂停、过期、撤销的密钥，或密钥所属工作空间、成员、资源组不可用时，返回 401 invalid_api_key。