Skip to main content

​
Get System Token (AccessToken)

Before calling the balance query API, you need to obtain a system token (AccessToken). 1 Go to Account Settings After logging in, visit the Account Settings page and click on “System Token”.System Token Entry 2 Verify Account Password Enter your account password in the popup dialog for identity verification.Password Verification 3 Get AccessToken After successful verification, the system will display your AccessToken. Copy and save it immediately.Token Result 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

ItemDescription
Endpoint URLhttps://api.yelinai.com/api/user/self
MethodGET
AuthenticationAuthorization Header
Response FormatJSON (gzip compressed)

​
Request Headers

Header NameRequiredDescription
AuthorizationYesSystem token, directly use the Token string
AcceptNoRecommended: application/json
Content-TypeNoRecommended: 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 NameTypeDescription
successBooleanWhether the request was successful
messageStringError message (null on success)
data.quotaIntegerRemaining quota (current available balance)
data.used_quotaIntegerUsed quota
data.request_countIntegerTotal request count
data.groupStringUser 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.yelinai.com/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.yelinai.com/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.yelinai.com/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.yelinai.com/api/user/self' -H 'Authorization: YOUR_TOKEN'

# Wrong (will be garbled)
curl 'https://api.yelinai.com/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