cURL 返回乱码或 jq 报错怎么办?
接口返回的是 gzip 压缩内容,cURL 默认不解压,所以终端会显示乱码,jq 也会报 Invalid numeric literal。建议在命令中加上 --compressed:
requests 会自动解压,不需要额外设置。
返回 401 Unauthorized 怎么办?
401 表示 AccessToken 没有通过认证。按以下顺序检查:Authorization请求头是否为空,当前终端是否已经设置LAOZHANG_ACCESS_TOKEN;- 复制的 AccessToken 是否完整;
- 之后是否又生成过新的 AccessToken——生成新的 AccessToken 可能使旧 Token 失效;
- 是否误用了调用模型的 API Key。
message 和打码后的请求命令发给支持团队(hi@laozhang.ai),不要发送完整的 AccessToken。
控制台有余额告警吗?
目前没有可以依赖的余额告警通知。用余额查询接口定时检查剩余额度,低于阈值时由你自己的监控系统发通知,脚本和 cron 示例见余额查询 API 的监控接入建议。AccessToken 和 API Key 有什么区别?
两者是不同的凭据,不能互换;误用 API Key 调用余额查询接口,是 401 的常见原因。
AccessToken 的权限高于 API Key,只在服务端使用,不要写进前端代码或提交到代码仓库。