在 CC Switch 中查看 ReverixAI 钱包余额
使用本机 API Key,通过只读查询查看人民币钱包余额、实付与赠送拆分,以及最近到期的赠送额度。
先确认你要查询的余额
账户钱包余额是当前 ReverixAI 账号可用的资金。API Key 是客户端使用的密钥,可以单独设置额度,因此 Key 额度可能小于钱包余额。本指南显示账户钱包,不把 Key 额度当成钱包余额。
钱包包含实付余额与赠送额度,已到期赠送不计入可用余额。最近到期项显示同一最早到期时刻的所有赠送批次剩余金额合计。
无限额 Key 仍显示账户实际钱包余额。钱包有余额,不代表当前 Key 一定能调用模型;Key 自身额度、状态和限制仍然生效。
准备 ReverixAI API Key
登录 ReverixAI,进入「API 密钥」,为 CC Switch 创建一个便于识别的 Key,或从已有 Key 的菜单复制。只把它填入本机 CC Switch 的供应商配置。
打开用量查询配置
在 CC Switch 中切换到你使用的应用,找到已配置的 ReverixAI 供应商。点击「更多(⋯)」→「配置用量查询」,阅读首次信任提示后继续。模板选择「自定义」,不要选择默认 NewAPI 模板。
审核并粘贴查询脚本
将下面完整脚本粘贴进自定义脚本编辑器。「API Key」留空时可沿用供应商密钥;若不能自动读取,在本机填入 ReverixAI Key。「Access Token」「User ID」均不需要填写。请求使用 Authorization: Bearer {{apiKey}}。
({ request: { url: "https://reverix.ai/api/usage/wallet", method: "GET", headers: { Authorization: "Bearer {{apiKey}}" } }, extractor: function(response) { var d = response && response.data; if (!response || response.success !== true || !d || d.currency !== "CNY" || typeof d.total_available_cny !== "number" || !isFinite(d.total_available_cny) || d.total_available_cny < 0 || typeof d.paid_available_cny !== "number" || typeof d.gift_available_cny !== "number") { return { isValid: false, invalidMessage: "钱包暂不可读,请稍后重试" }; } var extra = "实付 ¥" + d.paid_available_cny.toFixed(6) + " · 赠送 ¥" + d.gift_available_cny.toFixed(6); if (d.next_gift_expiry) { extra += " · 最近到期 ¥" + d.next_gift_expiry.amount_cny.toFixed(6) + "(" + d.next_gift_expiry.expires_at + ",UTC)"; } return { isValid: true, planName: "ReverixAI 账户钱包", remaining: d.total_available_cny, unit: "CNY", extra: extra + " · 快照 " + d.as_of }; } })
区分模型地址与钱包查询地址
Base URL https://reverix.ai/v1 用于模型请求。钱包查询使用独立的完整地址 https://reverix.ai/api/usage/wallet,不能加 /v1 前缀。脚本固定了查询目标,修改供应商 Base URL 不会把密钥转发到其他主机。本配置不依赖深链导入。
GET https://reverix.ai/api/usage/wallet Authorization: Bearer YOUR_REVERIX_API_KEY
测试、保存与自动刷新
审核脚本后,打开「启用用量查询」,点击「测试脚本」。确认结果为账户钱包且单位为 CNY,再保存。建议「自动查询间隔」设为 5–15 分钟,设为 0 则关闭自动刷新;仅「使用中」的供应商会自动查询。超时时间可先设为 10 秒。
理解返回金额与时间
提取器把 data.total_available_cny 映射到 remaining,单位固定为 CNY。实付与赠送拆分显示在 extra 中。接口返回最多六位小数的人民币数值;CC Switch 主金额可能四舍五入为两位小数,脚本在拆分说明中保留六位。脚本不需要再除 quota 系数或计算汇率。
没有将到期的赠送额度时,next_gift_expiry 为 null;否则 amount_cny 是 expires_at 时刻到期的金额,已经包含在赠送余额中,不是额外赠送。
expires_at 与 as_of 为以 Z 结尾的 UTC RFC3339 时间。as_of 是服务器快照时间,不代表资金已预留,也不是实时余额保证。UTC+8为 UTC+8。
原有 /api/usage/token 只查询当前 Key 的原始额度、已用额度和无限额状态。它的字段不是人民币钱包金额,不能直接套入本脚本。
查询异常时这样排查
先用「测试脚本」查看 HTTP 状态,再按以下项目排查。不要把完整 Key 或钱包原始响应发给客服。
401:检查本机 API Key 是否完整、属于 ReverixAI,且没有被禁用或撤销。使用 Bearer 鉴权,不要填登录 Cookie 或站点访问令牌。已到期或额度耗尽的 Key 仍可查询,但不一定能调用模型。
403:账号当前不可用,请在 ReverixAI 核对账号状态,不要通过改请求头绕过限制。
404:核对完整路径 /api/usage/wallet,移除误加的 /v1 前缀,并确认没有使用旧接口地址。
429:降低刷新频率,稍后重试。503 wallet_unavailable:钱包快照暂不可读,可能需要对账或存在待偿还余额;请稍后重试,必要时提供脱敏错误信息联系支持。查询不会修复或修改余额。
币种或金额不对:确认使用「自定义」脚本,unit 为 CNY,remaining 读取 data.total_available_cny。删除默认 NewAPI 模板的 quota / 500000 与 USD 映射。余额滞后时先手动刷新。
只在本机保存密钥
本查询不需要 ReverixAI 登录密码、站点访问令牌或用户 ID。不要将 Key 发给客服、放进截图、提交到代码仓库或加入共享供应商配置。若已泄露,请立即在「API 密钥」中禁用或撤销,重建 Key 并更新 CC Switch。导入配置或升级后,重新审核脚本及请求目标。