配置 CC Switch 用量查询

CC Switch 可以在供应商卡片上显示 GetToken 的余额或订阅额度。配置完成后，你可以直接在 CC Switch 里看到当前 API Key 是否可用、剩余额度、已用额度和套餐名称。

配置前准备

你需要准备两项信息：

GetToken API Key：在 GetToken 控制台的「API Key」页面查看或创建。
请求地址：填写 https://api.gettoken.dev。

如果你使用中国地区优化线路调用模型，模型请求可以继续使用 https://api.clawto.link。用量查询这里建议使用标准 API 地址 https://api.gettoken.dev，因为当前兼容接口固定在 /v1/user/balance。

打开用量查询配置

打开 CC Switch。
找到已经导入或手动创建的 GetToken 供应商。
在供应商卡片上点击「用量查询」按钮。
打开「启用用量查询」开关。
选择「自定义」或「通用模板」后改成下面的脚本。

填写凭证配置

按下面方式填写：

字段	填写内容
API Key	你的 GetToken API Key
请求地址 / Base URL	`https://api.gettoken.dev`
超时时间	`10`
自动查询间隔	建议 `5`，如果不想自动刷新可以填 `0`

提取器代码

把下面代码粘贴到「提取器代码」里：

({
  request: {
    url: "{{baseUrl}}/v1/user/balance",
    method: "GET",
    headers: {
      "Authorization": "Bearer {{apiKey}}",
      "User-Agent": "cc-switch/1.0"
    }
  },
  extractor: function(response) {
    return {
      isValid: response.isValid,
      invalidMessage: response.invalidMessage,
      remaining: response.remaining,
      unit: response.unit,
      planName: response.planName,
      total: response.total,
      used: response.used,
      extra: response.extra
    };
  }
})

最终请求地址会是：

text

https://api.gettoken.dev/v1/user/balance

测试并保存

点击「测试脚本」。
如果返回成功，确认剩余额度和单位能正常显示。
点击「保存配置」。
回到供应商卡片，启用 GetToken 供应商后即可看到用量信息。

返回字段说明

字段	说明
`isValid`	当前 API Key 或账户是否可用
`invalidMessage`	不可用时的原因，例如余额不足或订阅额度耗尽
`remaining`	当前可用余额或订阅剩余额度
`unit`	单位，GetToken 当前返回 `USD`
`planName`	订阅用户会返回套餐或分组名称；余额用户可能为空
`total`	当前统计窗口内的总额度
`used`	当前统计窗口内已使用额度
`extra`	额外说明，例如额度窗口或到期时间

常见问题

测试脚本返回 404

先确认请求地址是不是 https://api.gettoken.dev，并且脚本里的 URL 是 {{baseUrl}}/v1/user/balance。

不要把请求地址填成：

text

https://gettoken.dev
https://gettoken.dev/console

这些是网站和控制台地址，不是 API 查询地址。

显示 API Key 无效

检查 API Key 是否复制完整，前后不要带空格。也可以回到 GetToken 控制台确认这个 API Key 是否仍然存在、是否已被删除。

显示余额不足或额度耗尽

这通常表示接口查询成功，但当前账户余额不足，或订阅当日、当周、当月额度已经用完。你可以到 GetToken 控制台查看余额、订阅和使用记录。

订阅用户和余额用户显示有什么区别

余额用户通常显示账户余额，不一定返回 planName。

订阅用户会优先显示当前订阅额度窗口中最紧张的一项，例如日限、周限或月限，并返回对应的剩余额度、已用额度和套餐名称。

GetToken 使用说明

查看我的 API Key