How to Query Account Balance via API

Get System Token (AccessToken)

Before calling the balance query API, you need to obtain a system token (AccessToken).

Go to Account Settings

After logging in, visit the Account Settings page and click on “System Token”.

Verify Account Password

Enter your account password in the popup dialog for identity verification.

Get AccessToken

After successful verification, the system will display your AccessToken. Copy and save it immediately.

Security Warning:

AccessToken has full account permissions, keep it safe
Token is only displayed once when created, cannot be retrieved later
Generating a new Token will immediately invalidate the old one
Never hardcode in source code or commit to public repositories

API Reference

Endpoint Information

Item	Description
Endpoint URL	`https://api.laozhang.ai/api/user/self`
Method	GET
Authentication	Authorization Header
Response Format	JSON (gzip compressed)

Request Headers

Header Name	Required	Description
Authorization	Yes	System token, directly use the Token string
Accept	No	Recommended: `application/json`
Content-Type	No	Recommended: `application/json`

Response Fields

Successful response example:

{
  "success": true,
  "message": null,
  "data": {
    "username": "your_username",
    "display_name": "Your Name",
    "quota": 24997909,
    "used_quota": 10027091,
    "request_count": 339,
    "group": "svip"
  }
}

Core fields:

Field Name	Type	Description
success	Boolean	Whether the request was successful
message	String	Error message (null on success)
data.quota	Integer	Remaining quota (current available balance)
data.used_quota	Integer	Used quota
data.request_count	Integer	Total request count
data.group	String	User group

Quota Conversion Formula

Conversion Rule: 500,000 quota = $1.00 USD

USD Amount = quota ÷ 500,000
Example: quota: 24997909 → $49.99 USD (current remaining balance)

Code Examples

cURL
cURL Quick Test
Python

Basic Request (must add --compressed option):

curl --compressed 'https://api.laozhang.ai/api/user/self' \
  -H 'Accept: application/json' \
  -H 'Authorization: YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json'

Important: You must add --compressed option because the API returns gzip compressed content, otherwise you’ll get garbled output.

Using environment variables and jq to extract core info:

export LAOZHANG_TOKEN='YOUR_ACCESS_TOKEN'

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

-s option hides progress bar, --compressed auto-decompresses gzip response.

import requests

# Configuration
url = "https://api.laozhang.ai/api/user/self"
access_token = "YOUR_ACCESS_TOKEN"  # Replace with your token

# Headers
headers = {
    'Accept': 'application/json',
    'Authorization': access_token,
    'Content-Type': 'application/json'
}

# Send request
response = requests.get(url, headers=headers, timeout=10)

# Check response
if response.status_code == 200:
    data = response.json()
    user_data = data['data']

    # Extract core info
    quota = user_data['quota']
    used_quota = user_data['used_quota']
    request_count = user_data['request_count']

    # Calculate USD amount (500,000 quota = $1.00 USD)
    remaining_usd = quota / 500000
    used_usd = used_quota / 500000

    # Print results
    print(f"Remaining: ${remaining_usd:.2f} USD ({quota:,} quota)")
    print(f"Used: ${used_usd:.2f} USD ({used_quota:,} quota)")
    print(f"Request count: {request_count:,}")
else:
    print(f"Request failed: HTTP {response.status_code}")
    print(response.text)

Python’s requests library automatically handles gzip decompression, no extra configuration needed.

Error Handling

HTTP 401 - Authentication Failed

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

Cause: Authorization token is invalid or expired Solution: Check and update your system token

HTTP 403 - Permission Denied

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

Cause: Current token doesn’t have permission to access this endpoint Solution: Contact admin to verify permission settings

FAQ

What does the quota field represent?

The quota field represents your current remaining balance (available quota). If quota is 0 or near 0, your account balance is insufficient and needs to be recharged.

How to calculate remaining USD amount?

Use the formula: Remaining USD = quota ÷ 500,000Example: quota: 24997909 → $49.99 USD

curl command returns garbled output?

Cause: API returns gzip compressed content, curl doesn’t auto-decompress.Solution: Add --compressed option:

# Correct
curl --compressed 'https://api.laozhang.ai/api/user/self' -H 'Authorization: YOUR_TOKEN'

# Wrong (will be garbled)
curl 'https://api.laozhang.ai/api/user/self' -H 'Authorization: YOUR_TOKEN'

jq reports Invalid numeric literal error?

This usually happens because curl didn’t decompress the gzip content. Add --compressed option to fix it.

What is the ModelFixedPrice field for?

This field returns pricing information for various AI models. If you only care about balance info, you can ignore this field.

How to implement balance alerts?

You can write a scheduled script to periodically query the balance, and send alert notifications (email, Slack, etc.) when quota falls below a threshold.

Notes

Security

Use environment variables for Token
Don’t commit to public repos
Rotate Token regularly

Rate Limits

Set reasonable timeout (10s recommended)
Avoid too frequent queries
Recommended interval ≥ 1 minute

Error Handling

Handle network errors and timeouts
Handle authentication failures
Log errors for troubleshooting

Response Format

API returns gzip compressed content
curl must add --compressed
requests library handles automatically

User Guide

​Get System Token (AccessToken)

​API Reference

​Endpoint Information

​Request Headers

​Response Fields

​Quota Conversion Formula

​Code Examples

​Error Handling

​HTTP 401 - Authentication Failed

​HTTP 403 - Permission Denied

​FAQ

​Notes

Security

Rate Limits

Error Handling

Response Format

Get System Token (AccessToken)

API Reference

Endpoint Information

Request Headers

Response Fields

Quota Conversion Formula

Code Examples

Error Handling

HTTP 401 - Authentication Failed

HTTP 403 - Permission Denied

FAQ

Notes