> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 怎样通过 API 查询老张API账户余额？

> 查询老张API余额要用系统令牌 AccessToken，不能用 API Key。这里说明调用方法，以及 cURL 返回乱码和 401 认证失败的处理办法。

查询老张API账户余额，要用系统令牌 AccessToken 调用余额查询接口，不能用调用模型的 API Key。

| 项目 | 内容 |
| - | - |
| 接口 | `GET https://api.laozhang.ai/api/user/self` |
| 认证 | 把 AccessToken 直接填在 `Authorization` 请求头中 |
| 剩余额度 | 响应中的 `data.quota`，按 50 万额度约等于 1 USD 换算 |
| 完整说明 | 获取 AccessToken 的步骤、完整字段说明以及 Python 和 Node.js 示例见[余额查询 API](/api-capabilities/balance-query) |

## cURL 返回乱码或 jq 报错怎么办？

接口返回的是 gzip 压缩内容，cURL 默认不解压，所以终端会显示乱码，`jq` 也会报 `Invalid numeric literal`。建议在命令中加上 `--compressed`：

```bash theme={null}
export LAOZHANG_ACCESS_TOKEN="替换为你的 AccessToken"

curl --compressed -s "https://api.laozhang.ai/api/user/self" \
  -H "Authorization: ${LAOZHANG_ACCESS_TOKEN}"
```

Python 的 `requests` 会自动解压，不需要额外设置。

## 返回 401 Unauthorized 怎么办？

401 表示 AccessToken 没有通过认证。按以下顺序检查：

1. `Authorization` 请求头是否为空，当前终端是否已经设置 `LAOZHANG_ACCESS_TOKEN`；
2. 复制的 AccessToken 是否完整；
3. 之后是否又生成过新的 AccessToken——生成新的 AccessToken 可能使旧 Token 失效；
4. 是否误用了调用模型的 API Key。

仍然失败时，把请求时间、HTTP 状态码、返回的 `message` 和打码后的请求命令发给支持团队（[hi@laozhang.ai](mailto:hi@laozhang.ai)），不要发送完整的 AccessToken。

## 控制台有余额告警吗？

目前没有可以依赖的余额告警通知。用余额查询接口定时检查剩余额度，低于阈值时由你自己的监控系统发通知，脚本和 cron 示例见[余额查询 API 的监控接入建议](/api-capabilities/balance-query#监控接入建议)。

## AccessToken 和 API Key 有什么区别？

两者是不同的凭据，不能互换；误用 API Key 调用余额查询接口，是 401 的常见原因。

| 项目 | API Key | 系统令牌 AccessToken |
| - | - | - |
| 在哪里生成 | [令牌管理](https://api.laozhang.ai/token) | [账户设置](https://api.laozhang.ai/account/profile)中的「系统令牌」 |
| 用途 | 调用模型，例如 `/v1/chat/completions` | 账户管理接口，例如 `/api/user/self` |
| 请求头 | `Authorization: Bearer` 加 API Key | `Authorization` 直接填写 AccessToken |

AccessToken 的权限高于 API Key，只在服务端使用，不要写进前端代码或提交到代码仓库。

## 相关文档

* [余额查询 API](/api-capabilities/balance-query)
* [API Key 如何创建、保存、轮换和撤销？](/faq/token-management)
* [为什么还有余额但调用失败？](/faq/balance-insufficient)
* [如何查看和使用调用日志？](/faq/call-logs)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.