此接口使用系统令牌 AccessToken 认证,不是调用模型用的 API Key。AccessToken 权限更高,生产环境请放在服务端密钥管理系统或环境变量中,不要下发到浏览器或客户端 App。
获取 AccessToken
1
打开系统令牌
登录控制台的账户设置页面,在「账户选项」中点击「系统令牌」。

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

3
复制并保存
AccessToken 只在创建时显示,之后无法再次查看,请立即复制到安全位置。

接口信息
请求说明
请求 Headers
请求参数
此接口不需要 Query 参数,也不需要请求体。响应说明
成功响应示例
核心响应字段
额度与金额计算
接口返回的quota 单位是「额度」,不是直接的美元金额。当前余额展示按以下规则换算:
也就是说,
50 万额度约等于 1 USD。如果接口返回 quota: 24997909,用户当前可用余额约为 50.00 USD。
余额展示可以按上述公式计算;模型实际扣费仍要以当前模型价格、令牌分组、调用日志和控制台展示为准,计费规则见计费说明。
生产告警建议同时保存原始 quota 和换算后的美元金额,避免后续排查时丢失精度。
代码示例
以下示例从环境变量LAOZHANG_ACCESS_TOKEN 读取 AccessToken。
- cURL
- jq 提取
- Python
- Node.js
--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或账户敏感字段
相关文档
- cURL 乱码、401 以及 AccessToken 与 API Key 的区别:怎样通过 API 查询老张API账户余额?
- 余额仍然充足但请求失败:为什么还有余额但调用失败?
- 核对单次请求的模型、用量和计费:如何查看和使用调用日志?