订阅账号与 API 渠道
接入订阅账号、OpenAI 官方 API 和兼容 OpenAI 协议的第三方 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 管理员可查看重置卡列表，优先使用最早到期的合格卡片，并按需开启定时或额度耗尽自动使用。自动模式默认关闭，与手动使用共享每日上限。
接入订阅账号
- 以工作空间管理员身份打开 订阅账号 → 添加账号，选择订阅服务商并输入名称。
- 选择浏览器授权或导入凭据 JSON。Codex、Claude 和 Antigravity 在服务商页面完成登录后，把完整回调地址粘贴回 SubLane。Grok 使用设备码：在授权页确认显示的设备码，SubLane 会自动完成接入。
- 点击 验证连接，再打开 模型 查看该账号上报的模型目录。
- 将账号加入资源组，授予成员访问权，并创建个人网关密钥。
| 服务商 | 回调地址 |
|---|---|
| Codex | http://localhost:1455/auth/callback?... |
| Claude | http://localhost:54545/callback?... |
| Antigravity | http://localhost:51121/oauth-callback?... |
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 加密保存凭据，并与成员网关密钥分离。另见系统架构。