Balance & Alerts

Chuizi.AI provides multiple ways to monitor your spending and prevent unexpected charges. You can check your balance programmatically, receive email alerts, and set per-key spending limits.

Check Balance via API

Use the GET /v1/key/info endpoint to retrieve your current balance and key metadata:

terminal
bash
curl https://api.chuizi.ai/v1/key/info \
  -H "Authorization: Bearer ck-your-key-here"

Response:

config.json
json
{
  "key": {
    "name": "dev-local",
    "prefix": "ck-a1b2",
    "created_at": "2026-03-15T10:30:00Z",
    "is_active": true
  },
  "balance": "12.45000000",
  "currency": "USD",
  "usage_today": {
    "requests": 142,
    "tokens": 385200,
    "cost": "0.87500000"
  }
}

The balance field is a string (not a float) to preserve decimal precision.

Check Balance in Dashboard

Navigate to app.chuizi.ai/billing to see:

  • Current balance displayed prominently at the top
  • Spending chart showing daily costs over the last 30 days
  • Transaction history with every charge, top-up, and refund
  • Usage by model — which models are consuming the most budget

Low Balance Alerts

Chuizi.AI sends email notifications when your balance drops below a configurable threshold.

Default thresholds:

Balance remainingNotification
$5.00Warning email
$1.00Urgent email
$0.00Requests blocked (402 error)

To adjust thresholds, go to Settings > Notifications in the dashboard.

Next Steps

  • Billing Model — understand per-token, per-request, and per-second billing
  • Pricing — current model pricing
  • Top Up — add funds to your account