创建个人访问令牌
个人访问令牌不是调用模型用的 API Key:它只用来访问账户管理接口,按创建时勾选的权限工作。生产环境把它放在服务端密钥管理系统或环境变量中,不要下发到浏览器或客户端 App。接口信息
请求说明
请求 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,响应体里的code 说明原因。例如仍在使用旧令牌时:
脚本不要只看状态码,要检查响应里的
success 是否为 true。
响应乱码或 jq 报错
如果 cURL 返回乱码,或jq 报 Invalid numeric literal,通常是 gzip 响应没有被解压。请确认命令包含 --compressed。
监控接入建议
需要在余额不足前收到提醒时,用本接口做定时检查。下面的脚本在剩余金额低于阈值时以状态码 1 退出:LAOZHANG_ACCESS_TOKEN。接入时注意:
- 用环境变量或密钥管理服务保存
LAOZHANG_ACCESS_TOKEN - 设置合理超时时间,例如 10 秒
- 避免高频轮询;一般余额监控不需要秒级请求
- 告警里记录
quota、换算后的remaining_usd、used_quota、request_count、请求时间和 HTTP 状态码 - 不要在日志中记录完整
Authorization、access_token或账户敏感字段 - 修改密码、两步验证或通行密钥后,令牌会被撤销,告警脚本会开始返回 401;改完安全设置记得换新令牌
相关文档
- cURL 乱码、401 以及个人访问令牌与 API Key 的区别:怎样通过 API 查询老张API账户余额?
- 余额仍然充足但请求失败:为什么还有余额但调用失败?
- 核对单次请求的模型、用量和计费:如何查看和使用调用日志?
- 用程序导出调用记录与扣费:日志查询 API
- 用程序创建、禁用和删除 API Key:令牌管理 API