Skip to main content
用系统令牌 AccessToken 调用余额查询接口,可以读取老张API账户的剩余额度、已用额度和请求次数,适合接入后台监控、余额告警、账务排查脚本和内部运营面板。
此接口使用系统令牌 AccessToken 认证,不是调用模型用的 API Key。AccessToken 权限更高,生产环境请放在服务端密钥管理系统或环境变量中,不要下发到浏览器或客户端 App。

获取 AccessToken

1

打开系统令牌

登录控制台的账户设置页面,在「账户选项」中点击「系统令牌」。控制台账户选项中的系统令牌按钮
2

验证账户密码

在弹出的对话框中输入账户密码并点击「获取」。生成新的 AccessToken 可能使旧 Token 失效,仍在使用旧 Token 的脚本需要同步更新。输入账户密码以获取 AccessToken
3

复制并保存

AccessToken 只在创建时显示,之后无法再次查看,请立即复制到安全位置。复制新生成的 AccessToken
不要在代码仓库、前端页面、日志、截图或工单里暴露完整 AccessToken。向技术支持排查时,只提供 Header 名称、请求时间、HTTP 状态码和已打码的令牌片段。

接口信息

请求说明

请求 Headers

请求参数

此接口不需要 Query 参数,也不需要请求体。

响应说明

成功响应示例

核心响应字段

接口可能随账户状态返回更多字段。开发时请只依赖业务需要的核心字段,并允许响应中出现未知字段,避免因为新增字段导致解析失败。

额度与金额计算

接口返回的 quota 单位是「额度」,不是直接的美元金额。当前余额展示按以下规则换算: 也就是说,50 万额度约等于 1 USD。如果接口返回 quota: 24997909,用户当前可用余额约为 50.00 USD。 余额展示可以按上述公式计算;模型实际扣费仍要以当前模型价格、令牌分组、调用日志和控制台展示为准,计费规则见计费说明。 生产告警建议同时保存原始 quota 和换算后的美元金额,避免后续排查时丢失精度。

代码示例

以下示例从环境变量 LAOZHANG_ACCESS_TOKEN 读取 AccessToken。
建议保留 --compressed,它让 cURL 自动解压 gzip 响应。少了这个选项,终端可能显示乱码,jq 也可能报 Invalid numeric literal。

错误响应

HTTP 401 - 认证失败

常见原因是 Authorization 为空、令牌复制不完整、令牌已失效(例如之后又生成了新的 AccessToken),或误用了调用模型的 API Key。

HTTP 403 - 权限不足

常见原因是当前令牌无权访问账户信息接口,或账户状态需要人工确认。

响应乱码或 jq 报错

如果 cURL 返回乱码,或 jq 报 Invalid numeric literal,通常是 gzip 响应没有被解压。请确认命令包含 --compressed。

监控接入建议

  • 用环境变量或密钥管理服务保存 LAOZHANG_ACCESS_TOKEN
  • 设置合理超时时间,例如 10 秒
  • 避免高频轮询;一般余额监控不需要秒级请求
  • 告警里记录 quota、换算后的 remaining_usd、used_quota、request_count、请求时间和 HTTP 状态码
  • 不要在日志中记录完整 Authorization、access_token 或账户敏感字段

相关文档