Balance API: /api/user/self with AccessToken

Read your account’s remaining quota, used quota, and request count with a system AccessToken. Use this endpoint for low-balance alerts, billing checks, and internal dashboards.

Item	Details
Endpoint	`GET https://api.laozhang.ai/api/user/self`
Authentication	A system AccessToken in the `Authorization` header
Main fields	Remaining quota, used quota, request count, and account group
Conversion	Divide `quota` by 500,000 to get the remaining balance in US dollars; see Convert quota to US dollars

This endpoint uses a system AccessToken, not the API key you use for model requests. An AccessToken has broader account permissions, so keep it on your server in an environment variable or a secrets manager.

Get an AccessToken

Open account settings

Open the system token dialog

Select System Token, then enter your account password when the console asks for it.

Copy the AccessToken

Copy the AccessToken as soon as it appears and store it securely. Generating a new AccessToken may invalidate the previous one, so update every service that uses it.

Do not put the AccessToken in source code, browser apps, logs, screenshots, or support tickets. When you ask support for help, send the request time, HTTP status, response message, and a redacted command.

Endpoint

GET https://api.laozhang.ai/api/user/self
Authorization: <your AccessToken>

The request takes no query parameters or body, and the response is JSON. Pass the AccessToken itself as the Authorization value, as the examples below do. Accept: application/json and Content-Type: application/json are optional. With cURL, --compressed is recommended so that the response is decompressed.

Response

A successful request returns:

{
  "success": true,
  "message": null,
  "data": {
    "id": 12345,
    "username": "demo_user",
    "display_name": "demo_user",
    "role": 1,
    "status": 1,
    "email": "",
    "quota": 24997909,
    "used_quota": 10027091,
    "request_count": 339,
    "group": "default",
    "ModelFixedPrice": []
  }
}

Field	Type	Description
`success`	Boolean	Whether the request succeeded.
`message`	String or null	Error message; usually `null` on success.
`data.quota`	Integer	Remaining quota; use it for alert thresholds.
`data.used_quota`	Integer	Quota used so far.
`data.request_count`	Integer	Total number of requests.
`data.group`	String	Account group.
`data.username`	String	Username.
`data.display_name`	String	Display name.
`data.ModelFixedPrice`	Array	Model price data; ignore it if you only need the balance.
`data.access_token`	String	Sensitive; if it is returned, never write it to logs.

The response can include other fields, depending on the account. Read only the fields you need, and let your parser ignore unknown ones.

Convert quota to US dollars

quota and used_quota are returned in quota units, not dollars. 500,000 quota units are about 1 USD.

Value	Formula	Sample response
Remaining balance	`quota ÷ 500,000`	`24997909 ÷ 500,000` ≈ 50.00 USD
Amount used	`used_quota ÷ 500,000`	`10027091 ÷ 500,000` ≈ 20.05 USD
Remaining plus used	`(quota + used_quota) ÷ 500,000`	≈ 70.05 USD

Use this conversion for display. What a request actually costs depends on the model price, your token group, and the charge shown in call logs. For alerts, store the raw quota together with the converted amount so that you keep full precision.

Code examples

Set the AccessToken in your terminal once, replacing the placeholder:

export LAOZHANG_ACCESS_TOKEN="YOUR_ACCESS_TOKEN"

cURL
cURL with jq
Python
Node.js

curl --compressed -s "https://api.laozhang.ai/api/user/self" \
  -H "Accept: application/json" \
  -H "Authorization: $LAOZHANG_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

Without --compressed, the terminal can show garbled output, and jq can report Invalid numeric literal.

curl --compressed -s "https://api.laozhang.ai/api/user/self" \
  -H "Accept: application/json" \
  -H "Authorization: $LAOZHANG_ACCESS_TOKEN" \
  -H "Content-Type: application/json" |
  jq '.data | {
    quota,
    remaining_usd: (.quota / 500000),
    used_quota,
    used_usd: (.used_quota / 500000),
    request_count,
    group
  }'

Install requests with python -m pip install requests, then run:

import os
import requests

response = requests.get(
    "https://api.laozhang.ai/api/user/self",
    headers={
        "Accept": "application/json",
        "Authorization": os.environ["LAOZHANG_ACCESS_TOKEN"],
        "Content-Type": "application/json",
    },
    timeout=10,
)
response.raise_for_status()
payload = response.json()
if not payload.get("success"):
    raise SystemExit(f"Balance query failed: {payload.get('message')}")

account = payload["data"]
quota_per_usd = 500_000
print("quota:", account["quota"])
print("remaining_usd:", round(account["quota"] / quota_per_usd, 2))
print("used_quota:", account["used_quota"])
print("used_usd:", round(account["used_quota"] / quota_per_usd, 2))
print("request_count:", account["request_count"])
print("group:", account.get("group"))

requests decompresses gzip responses automatically.

Save this code in an .mjs file and run it with Node.js 18 or later:

const response = await fetch("https://api.laozhang.ai/api/user/self", {
  headers: {
    Accept: "application/json",
    Authorization: process.env.LAOZHANG_ACCESS_TOKEN,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(10_000),
});
if (!response.ok) {
  throw new Error(`Balance query failed: HTTP ${response.status}`);
}

const payload = await response.json();
if (!payload.success) {
  throw new Error(`Balance query failed: ${payload.message}`);
}

const account = payload.data;
const quotaPerUsd = 500_000;
console.log({
  quota: account.quota,
  remaining_usd: Number((account.quota / quotaPerUsd).toFixed(2)),
  used_quota: account.used_quota,
  used_usd: Number((account.used_quota / quotaPerUsd).toFixed(2)),
  request_count: account.request_count,
  group: account.group,
});

Errors

401 Unauthorized

{
  "success": false,
  "message": "Unauthorized"
}

The Authorization header is empty, the AccessToken is incomplete or no longer valid, or the request sent a model API key instead of the AccessToken. Fix a 401 from the balance API walks through each cause.

403 Forbidden

{
  "success": false,
  "message": "Forbidden"
}

The credential does not have permission for this endpoint, or the account needs attention from support.

Garbled output or a jq error

If cURL prints garbled characters or jq reports Invalid numeric literal, the compressed response was not decoded. Add --compressed to the cURL command.

Monitoring recommendations

Store LAOZHANG_ACCESS_TOKEN in an environment variable or a secrets manager.
Set a request timeout, such as 10 seconds.
Poll at a modest interval; balance alerts rarely need per-second checks.
Include quota, the converted balance, used_quota, request_count, the request time, and the HTTP status in alerts.
Never log the Authorization header, access_token, or other sensitive account fields.

Get started

Image Generation & Editing APIs

Video Generation APIs

Text APIs

Multimodal & Audio APIs

Balance API: /api/user/self with AccessToken

Get an AccessToken

Endpoint

Response

Convert quota to US dollars

Code examples

Errors

401 Unauthorized

403 Forbidden

Garbled output or a jq error

Monitoring recommendations

​Get an AccessToken

​Endpoint

​Response

​Convert quota to US dollars

​Code examples

​Errors

​401 Unauthorized

​403 Forbidden

​Garbled output or a jq error

​Monitoring recommendations

​Related documentation

Get an AccessToken

Endpoint

Response

Convert quota to US dollars

Code examples

Errors

401 Unauthorized

403 Forbidden

Garbled output or a jq error

Monitoring recommendations

Related documentation