All API Hub 是开源浏览器扩展，可集中管理 青云TOP API 的余额、密钥、模型和下游客户端配置。它是配置管理工具，不是聊天客户端。

1\. 安装扩展

优先从官方渠道安装，以便自动更新：

GitHub Stable 手动版需要在扩展管理页开启开发者模式并“加载已解压的扩展”，且不会自动更新。

2\. 先登录 青云TOP API

  1. 在安装扩展的同一个浏览器配置文件中打开 https://top.qingyuntop.ai/dashboard/。
  2. 登录 青云TOP API 控制台并保持登录。
  3. 点击浏览器工具栏中的 All API Hub 图标。

3\. 自动识别并添加账号

  1. 点击 添加账号。
  2. 站点地址填写 https://top.qingyuntop.ai/dashboard/。
  3. 点击 自动识别。
  4. 检查站点名称、用户名和用户 ID 是否属于当前账号。
  5. 点击 保存账号。

亚太站账号填写实际登录的 https://top.qingyuntop.ai/dashboard/，不要混用两个站点的登录信息。

4\. 自动识别失败时手动添加

  1. 确认 青云TOP API 登录发生在安装扩展的同一浏览器配置文件。
  2. 关闭会阻止当前站点 Cookie 的临时隐私限制后重试。
  3. 仍失败时选择 手动输入。
  4. 只从当前 青云TOP API 登录会话复制用户 ID 与 Access Token。
  5. 保存前再次核对站点地址。

5\. 管理 青云TOP API API 密钥

  1. 打开 密钥管理。
  2. 选择刚添加的 青云TOP API 账号并刷新列表。
  3. 可以查看、创建、编辑、删除或复制 API Key。
  4. 需要反复导出时，将选定密钥保存到 API 凭据库。

![青云TOP API 创建 API 密钥和分组配置](https://docs.qingyuntop.ai/images/青云TOP API-api-key-form.png)

青云TOP API 创建 API 密钥时必须核对模型分组

6\. 查看模型与价格

  1. 打开 模型价格。
  2. 数据源选择 青云TOP API 账号或 青云TOP API API 凭据。
  3. 刷新并搜索准确模型 ID。
  4. 核对模型是否可见、协议、倍率和价格。

模型不可见时，应更换 青云TOP API 密钥分组；不要在导出目标中手写当前凭据看不到的模型。

7\. 导出到客户端

  1. 返回 密钥管理，找到要使用的 青云TOP API 密钥。
  2. 点击 导出，选择 Cherry Studio、CC Switch、Kilo Code、CLIProxyAPI、Claude Code Router 等目标。
  3. 在导出预览中核对：站点地址 https://top.qingyuntop.ai/dashboard/、OpenAI-compatible Base URL https://top.qingyuntop.ai/v1、掩码 Key 和准确模型 ID。
  4. 确认后再写入目标客户端。
  5. 到目标客户端选择模型并发送一次请求。

8\. 导入其他兼容站点（可选）

  1. 打开 基础设置 → 自建站点管理。
  2. 添加自己的后台地址和管理员凭据。
  3. 回到 青云TOP API 密钥管理，选择 导入到自建站点。
  4. 核对渠道名称、Bearer Key、Base URL 和模型映射。
  5. 导入后在自建后台执行一次渠道测试。

不要把 青云TOP API 用户中心的 Access Token 当作上游模型 Key。

9\. 本地数据与备份

  • 默认数据保存在当前浏览器本地。
  • JSON 导出可能包含账号令牌和 API Key，应作为敏感文件保管。
  • 只有主动配置 WebDAV 后，数据才会同步到指定存储。

常见问题

  • 自动识别失败：确认登录发生在同一浏览器配置文件。
  • 余额能看但没有密钥：检查账号权限，或先在 青云TOP API 创建模型 API Key。
  • 导出后地址错误：站点识别使用根地址；OpenAI-compatible 客户端通常使用带 /v1 的地址。
  • 模型列表缺少目标模型：密钥分组不包含该模型。

发布前检查

以下检查适用于客户端中选择 OpenAI 兼容 或 Responses 提供商的场景；如果你选择的是 Anthropic、Gemini 等原生协议，请按对应协议的接口和返回结构配置。

  1. 模型 ID：先用目标 API Key 请求 GET https://top.qingyuntop.ai/v1/models，把返回的 data[].id 原样填入客户端。截图、教程和历史配置中的模型名不保证仍可用。
  2. 协议选择：新 OpenAI 集成优先选择 Responses；只有客户端或模型明确要求 Chat Completions 时才选择 Chat。Responses 的返回从 output 读取，Chat 的返回从 choices[].message 读取。
  3. Base URL：通常填写 https://top.qingyuntop.ai/v1，也就是只保留一个 /v1。要求完整接口地址的客户端才追加 /responses 或 /chat/completions，不要重复追加。
  4. 流式与重试：流式响应必须按所选协议解析事件；连接中断后不要盲目重放可能已被服务端接受的生成请求。对 429 和 5xx 使用带抖动的退避，并设置连接、读取和总超时。
  5. 上线前验证：分别验证普通文本、流式文本、工具调用或结构化输出中实际用到的能力，并记录 request id、HTTP 状态、业务状态和完成原因，避免只根据 HTTP 200 判定成功。