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 凭据库 中，后续使用会更方便。

寻找优质 API 接口？

如果你需要稳定且支持 CLI 的 API 接口来填充你的凭据库，可以尝试我们的合作伙伴 PackyCode（注册并充值时填写 all-api-hub 优惠码可享 9 折）。

如何添加凭证

基础字段

字段说明
名称便于区分不同用途，例如“公司中转站只读 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