CC Switch · 模型与余额

地址与密钥

在本站创建 API 密钥，选择要使用的分组。CC Switch 使用该密钥自动识别分组，无需填写分组名称、用户 ID 或后台管理令牌。

Claude Code：Base URL 填本站根地址 https://pelicanapi.com。
Codex / OpenAI 客户端：Base URL 填 https://pelicanapi.com/v1，协议选择 Responses。
本机预览根地址为 http://127.0.0.1:3001；其他设备使用服务器 IP 或域名。

不要把上游 DDShub 密钥填进本站配置，应使用本站「API 密钥」页面生成的密钥。

获取模型列表

在 CC Switch 编辑供应商，填写地址与密钥，然后点击「获取模型列表」。本站的 /v1/models 返回这个密钥可用的模型：

优先使用密钥分组；密钥未设置分组时跟随账户分组。
只列出已启用渠道中、在后台模型目录发布且属于该分组的模型。
密钥配置了模型限制时，进一步取交集。

例如 claude-max 密钥会显示该分组的 Claude 模型，不会混入 codex-basic 的模型。新增模型并成功接入渠道后，再点击获取即可更新。

列表表示后台已配置路由；上游故障或上游凭证无权限仍可能导致实际调用失败。

查询余额

CC Switch 的第三方余额查询需要启用并配置查询脚本。操作方式见 CC Switch 官方说明。

在供应商卡片点击「用量查询 / 查询余额」。
开启「启用用量查询」，模板选择「自定义」。
API Key 和 Base URL 留空，复用供应商的配置；不需要 Access Token 或用户 ID。
粘贴下面的脚本，点击「测试脚本」，成功后保存。建议自动查询间隔设为 5 分钟。

({
  request: {
    url: "{{baseUrl}}/user/balance",
    method: "GET",
    headers: {
      "Authorization": "Bearer {{apiKey}}",
      "User-Agent": "cc-switch/1.0"
    }
  },
  extractor: function(response) {
    if (!response || response.error || response.is_active !== true) {
      return {
        isValid: false,
        invalidMessage: response && response.error ? response.error.message : "余额查询失败"
      };
    }
    return {
      isValid: true,
      planName: response.group,
      remaining: response.balance,
      unit: response.unit,
      extra: "账户余额 " + response.account_balance.toFixed(4) + " 积分；" +
        (response.unlimited_quota ? "密钥不限额" : "密钥剩余额度 " + response.token_balance.toFixed(4) + " 积分")
    };
  }
})

返回单位为积分，1 人民币 = 1 积分。卡片的剩余额度为当前密钥实际可用额度：

不限额密钥：账户剩余额度。
限额密钥：账户余额和密钥剩余额度中较小的值。

附加信息显示账户余额与密钥限额。不限额密钥并不代表账户可无限消费。

查询接口为 GET /user/balance，也支持 GET /v1/user/balance。它只读取本站数据，不调用上游模型、不扣积分。额度为零仍可查询；失效、过期或被停用的密钥无法查询。

不要直接使用把单位固定写成 USD 的默认通用脚本，否则会把积分误标成美元。