编程工具 · 更新于 2026-10-03
CC Switch:获取模型列表与查询余额
用本站地址和分组密钥获取可用模型,并查看实际可用积分。
先确认这三项
- 站点地址填写
https://pelicanapi.com;需要 OpenAI Base URL 的配置项使用https://pelicanapi.com/v1。 - API 密钥使用本站创建的分组密钥,不是站长管理令牌,也不是上游中转站的密钥。
- 客户端选择的接口类型必须与模型及分组匹配。
获取模型列表
本站提供 GET /v1/models。请求认证支持 Bearer 密钥;Anthropic 客户端也可使用 x-api-key。
点击客户端的获取模型列表时,本站根据密钥识别分组,只返回该组已接入且密钥有权限使用的模型。后台增加模型后重新获取列表即可同步。
分组不能通过修改客户端里的文字随意切换,需要创建对应分组的密钥。模型列表不代表上游始终在线,实际调用仍可能遇到临时故障。
查询余额
余额接口是 GET https://pelicanapi.com/user/balance,也支持 /v1/user/balance,使用同一分组 API 密钥认证。
客户端余额模板应读取返回的 balance 字段,显示单位为积分;1 元人民币 = 1 积分。字段 group 是密钥实际所属分组。
限额密钥的可用余额取账户余额与密钥剩余额度中较小的值。所以密钥显示的余额可能低于账户页面,这是正常的额度限制。
不同版本的 CC Switch 配置界面可能不同。如果只有自定义查询脚本,需要按该版本的模板设置 URL、认证头和返回字段。
常见问题
- 获取列表为空:核对密钥分组、密钥模型限制、后台渠道是否启用。
- 列表有模型但调用失败:核对完整模型名、接口类型、分组限制和上游状态。
- 查询显示为美元:核对客户端显示单位,不要对
balance再乘汇率。 - 查询失败:确认请求没有被旧代理转发到停用的本机端口。
不要向公开群或客服发送完整密钥,可以提供打码后的配置和错误码。