进阶:面板 API 与访问令牌

这是一篇进阶教程

普通用户不需要看这一页——查余额、看日志在网页面板里点几下就行。这一页给需要自建查询脚本、接 CC Switch 余额显示的用户。

先分清两种凭证(最重要)

	面板访问令牌	模型 API 密钥
用途	查询个人资料、余额、消费记录;管理自己的 API 密钥	调用 GPT 等模型
样式	一串随机字符串,不是 sk- 开头	通常 sk- 开头
填在哪里	CC Switch 余额查询、自建脚本	CC Switch、Cherry Studio、zCode、DSH 等客户端
在哪创建	「安全与访问」页	「API 密钥」页

两者不能互相替代:查账户用访问令牌,调模型用 API 密钥。

获取面板访问令牌

1. 登录控制台,右上角头像菜单或左侧栏进入 安全与访问

   

2. 找到「访问令牌」区块,点击 生成

   

3. 复制并妥善保存。令牌只显示一次;重新生成后旧令牌立即失效,使用旧令牌的应用会停止工作

常用接口速查

本站地址:https://api.123336.xyz

需求	用哪种凭证	接口
查个人资料、账户余额	面板访问令牌	GET /api/user/self
查个人消费记录	面板访问令牌	GET /api/log/self
查消费统计	面板访问令牌	GET /api/log/self/stat
管理自己的 API 密钥	面板访问令牌	GET / POST /api/token/
查单个 sk- 密钥余额	模型 API 密钥	GET /api/usage/token/
调用模型	模型 API 密钥	/v1/chat/completions、/v1/responses

以上面板查询使用 Authorization: Bearer 你的令牌；GET 请求不需要 Content-Type。模型协议、模型列表和调用示例见开发者接入，不要把面板路径加进模型 SDK 的 Base URL。

注意

「查单个 sk- 密钥余额」只有在创建该密钥时设置了固定额度才有数据;无限额度的密钥不返回余额。

余额换算

接口返回的是内部额度单位,不是金额:

基础计价数值 = quota ÷ quota_per_unit
显示金额 ≈ 基础计价数值 × 站点显示换算系数

2026-10-15 核对公开 /api/status：quota_per_unit = 500000、quota_display_type = CNY、usd_exchange_rate = 1。按当前显示配置，quota = 3750000 对应约 ¥7.50。

这是站点内部额度的显示换算，不是实时美元汇率。写余额脚本时先读取本站配置，或直接以面板显示为准；不要固定把结果标成美元。

命令行测试

curl https://api.123336.xyz/api/user/self \
  -H "Authorization: Bearer 你的面板访问令牌"

CC Switch 余额查询配置

在 CC Switch 的「账户余额」配置中:

• 请求地址:https://api.123336.xyz —— 不要加 /v1 或 /api
• 访问令牌:填面板访问令牌(不是 sk- 密钥)
• userId:留空

常见错误

• 401:令牌错误、已重新生成、Bearer 格式不对,或令牌前后带了空格
• 403:账号被禁用或无该操作权限
• 余额显示很大:那是内部额度单位,记得除以 500,000

安全提醒

面板访问令牌权限较大:不要发到群聊、截图、工单或公开仓库;不要与 sk- 密钥混用;怀疑泄露立即到「安全与访问」页重新生成。修改资料、删除账户、管理登录会话等敏感操作,请直接在网页面板完成,不要走 API。