在 CC Switch 中查看用量

让 AI 帮你完成配置

首次安装或切换到 XXAPI，都可以使用。

AI 打不开链接时，。

查看短提示词

我想通过 XXAPI 使用 CC Switch 用量查询，请先确认我的电脑系统（Windows / macOS / Linux）。请先阅读教程：
https://docs.xxapi.ai/text/usage-query.txt

先确认我是首次安装还是更换服务商。能操作本机时，请先检查并备份配置，再协助完成；只能聊天时，每次带我做一步，等我反馈再继续。密钥由我在本机填写，完成后验证连接。打不开链接就告诉我，我会提供完整教程。

已经用 CC Switch 配好 XXAPI 后，可以给服务商卡片加上用量查询。这个操作可选，不影响模型对话。

1. 准备访问令牌和用户 ID

这里需要的是账户管理用的访问令牌。模型调用页面创建的 API Key 不能直接代替它。访问令牌权限更广，只填写到你信任的本地 CC Switch 中，不要贴进聊天或截图。

2. 打开用量查询

回到 CC Switch，在 XXAPI 服务商卡片上打开 配置用量查询。

CC Switch 服务商卡片上的用量查询入口 — XXAPI 用量查询配置示意。账号与访问令牌使用自己的值，示例卡片不展示真实账户金额。

启用用量查询，预设模板选择 NewAPI。

选择 NewAPI 查询模板 — XXAPI 用量查询配置示意。账号与访问令牌使用自己的值，示例卡片不展示真实账户金额。

3. 填入查询参数

项目	填写内容
请求地址 / Base URL	`https://xxapi.ai`
系统访问令牌 / Access Token	安全设置里生成的访问令牌
用户 ID / User ID	自己账号的数字 ID

地址不加 /v1，模板会自行请求账户接口。保留模板中的解析逻辑，第一次配置无需修改脚本。

填写查询地址、访问令牌与用户 ID — XXAPI 用量查询配置示意。账号与访问令牌使用自己的值，示例卡片不展示真实账户金额。

4. 保存并刷新

点击保存配置，回到服务商列表，手动刷新 XXAPI 卡片。能得到成功结果，并且对应自己的账号，就表示查询已接通。

服务商卡片显示查询结果 — XXAPI 用量查询配置示意。账号与访问令牌使用自己的值，示例卡片不展示真实账户金额。

首次使用请与 XXAPI 控制台核对。客户端模板使用固定的显示换算方式；若与平台显示单位不同，以平台数据为准，不要为了让数字相同随意修改账号设置。

已有用量查询怎么改

编辑 XXAPI 这一条查询配置，更新根地址、访问令牌和用户 ID。它们应当属于同一账号。重新生成过访问令牌后，记得来这里同步更新。

遇到问题

看到的情况	处理方法
401、认证失败	检查填的是访问令牌，而非模型调用 Key；若已撤销或重新生成，需要更新
用户 ID 不匹配	检查数字 ID 是否属于生成访问令牌的账号
404	地址只填 `https://xxapi.ai`，去掉 `/v1` 和手工添加的接口路径
查询失败，但模型可用	两种认证独立；可以暂时关闭查询，继续正常调用模型
显示单位或数值不一致	以 XXAPI 控制台为准，并检查当前 CC Switch 的 NewAPI 模板版本

查询机制与官方文档

CC Switch 的 NewAPI 模板通过 GET /api/user/self 读取账号信息，并发送访问令牌及 New-Api-User 用户 ID 请求头。实际账户授权是否有效，以保存后的查询结果为准。

CC Switch 用量查询模板

在 CC Switch 中查看用量 ​

1. 准备访问令牌和用户 ID ​

2. 打开用量查询 ​

3. 填入查询参数 ​

4. 保存并刷新 ​

已有用量查询怎么改 ​

遇到问题 ​