接口概述
余额查询 API 用于读取当前账户的剩余额度、已使用额度、请求次数和用户分组。它适合接入后台监控、余额告警、账务排查脚本和内部运营面板。此接口使用系统令牌 AccessToken 认证,不是普通模型调用用的 API Key。AccessToken 权限更高,生产环境请放在服务端密钥管理系统或环境变量中,不要下发到浏览器或客户端 App。
获取 Authorization
1
进入账户设置
登录 老张API 控制台,打开账户设置页面。
2
打开系统令牌
在账户设置中选择「系统令牌」,按页面提示进行密码验证。
3
保存 AccessToken
令牌生成后请立即复制到安全位置。生成新令牌后,旧令牌可能立即失效。
接口信息
请求说明
请求 Headers
请求参数
此接口不需要 Query 参数,也不需要请求体。生产代码中不要把余额阈值、告警渠道或业务标签拼到接口 URL 上;这些应保存在你的监控系统配置里。响应说明
成功响应示例
核心响应字段
额度与金额计算
接口返回的quota 单位是「额度」,不是直接的美元金额。当前余额展示按以下规则换算:
也就是说,
50 万额度约等于 1 USD。如果接口返回 quota: 24997909,用户当前可用余额约为 50.00 USD。
代码示例
- cURL
- jq 提取
- Python
- Node.js
--compressed 会让 cURL 自动处理 gzip 响应。如果少了这个选项,终端可能显示乱码,jq 也可能报 Invalid numeric literal。错误响应
HTTP 401 - 认证失败
Authorization 为空、令牌复制不完整、令牌已失效,或误用了普通 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或账户敏感字段
相关文档
- 如果只想看常见问题版说明,请查看如何通过 API 查询账户余额
- 如果余额仍然充足但请求失败,请查看为什么还有余额跑不通?
- 如果需要核对单次请求的模型、Token 和计费,请查看如何查看我的调用记录?