API 凭据库

适合“没有站点账号、只有 Base URL + API Key”的场景。你可以把常用 API Key 集中保存起来，用于快速复制、验证接口、查看模型与余额/用量，而不必先创建完整站点账号。

适合什么场景

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

功能概览

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

进入方式

  1. 打开插件设置页。
  2. 在左侧菜单进入 API 凭据库。
  3. 点击右上角 保存 API Key。

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

如何添加凭证

基础字段

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

API 类型

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

  • OpenAI Compatible
  • OpenAI
  • Anthropic
  • Google

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

余额与用量概览

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

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

查询方式

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

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

详细遥测指标

开启遥测后，插件会尝试获取以下指标：

  • 实时余额
  • 今日花费
  • 今日请求数
  • 今日 Prompt/Completion Tokens
  • 总已用/总赠送/总可用额度
  • 过期时间

自定义只读查询

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

  1. 选择 自定义只读查询。
  2. 填写查询地址（必须与 Base URL 同源，支持 /usage 这种根相对路径）。
  3. 配置字段映射：支持为上述所有遥测指标配置 JSON Path。
    • JSON Path 采用点分隔形式，例如 data.today_total_tokens。
    • 插件会自动解析并将其转换为统一的展示格式。

稳定性与频率限制

为了保护你的账号不被上游站点判定为异常调用，All API Hub 内置了智能频率限制器：

  • 并发控制：默认限制对单个站点的并发请求数为 2。
  • 速率控制：限制对单个站点的请求速率约为每分钟 18 次（支持小规模突发）。
  • 自动排队：当刷新多个账号或执行批量验证时，超出限制的请求会自动进入排队序列，避免触发 429 Too Many Requests 错误。

💡 说明：该限制主要针对插件后台的刷新和验证动作，不影响你通过其他工具（如 CherryStudio）直接调用接口的性能。

常用操作

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 Key，并用于接口验证、模型查看和导出；账号管理仍负责站点识别、余额刷新、签到、用量同步等账号级能力。
API 凭据库会参与备份吗？会。它属于共享数据的一部分，可随数据导入导出和 WebDAV 选择性同步一起迁移。

相关文档

最近更新:
Contributors: anime