API 凭证

适合“没有站点账号、只有 Base URL + API Key”的场景。你可以把独立接口凭证当作可复用的配置档案来管理、验证和导出，而不必先创建完整站点账号。

适合什么场景

  • 你手里只有第三方平台给出的 Base URL 和 API Key，但没有对应站点控制台账号。
  • 你想把常用接口配置集中保存，避免在多个客户端、CLI 工具之间来回复制。
  • 你需要先验证某个 Key 是否可用、是否兼容 CLI，再决定是否导入到下游工具。
  • 你希望把同一套接口配置直接复用到模型查看、接口验证或导出流程里。

功能概览

  • 独立档案管理：保存名称、Base URL、密钥、标签和备注，不依赖站点账号。
  • 搜索与筛选：支持按名称、Base URL、标签、备注以及 API 类型筛选。
  • 健康与用量概览：可查看余额、今日用量、今日请求数、可用模型数量、最近刷新时间和健康状态。
  • 接口验证：支持验证 API 是否可用，也支持单独验证 CLI 兼容性。
  • 模型联动：可直接在模型列表中打开当前凭证，查看模型目录和验证结果。
  • 快捷导出：支持导出到 CherryStudio、CC Switch、Kilo Code、CLIProxyAPI、Claude Code Router，以及当前配置的自建托管站点。

进入方式

  1. 打开插件设置页。
  2. 在左侧菜单进入 API 凭证。
  3. 点击右上角 添加凭证。

如果你已经在 密钥管理 中拿到了某个上游站点的 Key，也可以先在那里验证或整理，再把它保存到 API 凭证 中，后续复用会更方便。

如何添加凭证

基础字段

字段说明
名称便于区分不同用途，例如“公司中转站只读 Key”
Base URL接口基础地址，保存时会自动规范化
密钥对应的 API Key
标签可选；和账号、书签共用全局标签体系
备注可记录来源、用途、模型限制等信息

API 类型

当前支持按 API 类型分类和验证，常见类型包括：

  • OpenAI Compatible
  • OpenAI
  • Anthropic
  • Google

如果你临时用另一种 API 类型做验证，界面会明确提示这只是本次验证的临时覆盖，不会改写已保存的凭证类型。

余额与用量概览

每张凭证卡片都可以显示一个轻量遥测概览，常见指标包括：

  • 余额
  • 今日用量
  • 今日请求数
  • 今日 Tokens
  • 可用模型数量
  • 最近刷新时间
  • 健康状态与最近一次错误

查询方式

你可以为每个凭证选择余额/用量的查询方式：

  • Auto（自动探测）：按内置顺序尝试兼容方式。
  • NewAPI Token：适合兼容 New API 的 token 用量查询。
  • OpenAI Billing：适合标准 OpenAI Billing 查询。
  • Sub2API：适合 Sub2API 风格接口。
  • Custom Read-only Endpoint：适合站点有自定义只读查询接口。
  • Disabled（禁用）：不查询余额与用量，只保留凭证本身。

自定义只读查询

如果自动方式不适配当前站点，可改用自定义只读查询：

  1. 选择 Custom Read-only Endpoint。
  2. 填写查询地址。
  3. 配置返回 JSON 中各字段的路径映射。

限制如下：

  • 只允许当前 Base URL 同源下的只读 GET 地址。
  • 查询地址可以写成根相对路径，例如 /usage，也可以写完整同源 URL。
  • JSON Path 采用点分隔字段形式，例如 data.balance。
  • 至少需要配置一个可解析的字段映射。

这类配置适合“站点不是标准 New API / OpenAI Billing 返回格式，但你又希望在卡片上看余额和今日用量”的场景。

常用操作

1. 验证接口

点击卡片上的 验证接口，可以确认：

  • 当前 Key 是否还能调用
  • 模型列表是否可获取
  • 返回是否符合预期 API 类型

适合在更换 Key、切换网络或排查“客户端连不上，但站点似乎还活着”的情况时使用。

2. 验证 CLI 兼容性

点击 验证 CLI 兼容性，可单独测试：

  • 当前接口是否适合 CLI 工具
  • 模型 ID 是否可用于 CLI 场景
  • 是否存在“网页能调，CLI 不能调”的兼容性差异

3. 在模型管理中打开

点击 在模型管理中打开 后，模型列表页会直接把当前 API 凭证当作数据源。这样你不需要先创建站点账号，也能查看模型目录、验证模型可用性。

4. 快捷导出

支持从单个凭证直接导出到：

  • CherryStudio
  • CC Switch
  • Kilo Code
  • CLIProxyAPI
  • Claude Code Router
  • 当前自建托管站点

如果你主要是“管理一堆上游接口配置，然后分发到多个下游工具”，API 凭证 会比完整账号管理更直接。

使用建议

  • 命名带用途：例如“OpenAI 只读测试 Key”“公司中转站 Claude 专用 Key”，后期筛选会更清晰。
  • 把标签当分组：例如 工作、个人、生产、测试、临时。
  • 先验证再导出：这样能避免把失效 Key 批量导入到多个客户端。
  • 备注写限制条件：例如“仅支持 Anthropic”“余额展示不准”“仅内网可用”。

常见问题

问题说明
只保存了凭证，为什么没有余额数据？当前查询方式可能不适配该站点，或站点没有提供对应只读接口；可尝试切换查询方式或使用自定义只读查询。
模型相关验证为什么要求模型 ID？某些 CLI 兼容性检查和模型调用验证必须指定模型，界面会尽量自动获取建议模型，也可以手动填写。
可以替代账号管理吗？不能完全替代。API 凭证 更适合接口复用、验证和导出；账号管理仍负责站点识别、余额刷新、签到、用量同步等账号级能力。
API 凭证会参与备份吗？会。它属于共享数据的一部分，可随数据导入导出和 WebDAV 选择性同步一起迁移。

相关文档

最近更新:
Contributors: anime