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 remaining | Notification |
|---|---|
| $5.00 | Warning email |
| $1.00 | Urgent email |
| $0.00 | Requests 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