API reference
Check your balance
What the account behind a key can still spend, and the limits on the key itself. Use it to show a balance in your own app or to stop a job before it runs dry.
https://api.oneapi.id/v1/me- Key header
Authorization: Bearerorx-api-key- Body
- None
- Cost
- Free, not billed
Request
curl https://api.oneapi.id/v1/me \
-H "Authorization: Bearer $ONEAPI_API_KEY"Response
{
"object": "me",
"status": "active",
"balance_usd": "9.9998998468",
"available_usd": "9.9998998468",
"free_credit_usd": "0.00",
"model_credits": [
{
"models": ["deepseek-v4.1-flash"],
"all_models": false,
"amount_usd": "25.00",
"remaining_usd": "18.40",
"expires_at": null
}
],
"key": {
"id": "0b8f0c1e-6f0e-4d4e-9d6a-3b1c2a7f9e10",
"name": "production",
"rpm_limit": 1000,
"concurrency_limit": 50,
"quota_limit": null,
"quota_period": null,
"allowed_models": [],
"expires_at": null
}
}Money is sent as decimal strings in US dollars, exactly as stored, so nothing is rounded for you. Round or truncate when you display it.
statusstringactive, or frozen when the account is suspended and cannot make requests.
balance_usdstringThe account balance.
available_usdstringWhat a new request can still draw: the balance minus what requests in flight have reserved. Use this one to decide whether to send more.
free_credit_usdstringFree credit. It pays only for models marked Free.
model_creditsobject[]Redeemed credit that is limited to some models or expires. It is separate from the balance and is used first where it applies. Expired credit is left out.
model_credits[].modelsstring[]The only models the credit can pay for. Empty when all_models is true.
model_credits[].all_modelsbooleantrue for credit that works on any model but expires.
model_credits[].remaining_usdstringWhat is left of amount_usd.
model_credits[].expires_atstring | nullRFC 3339 time the credit lapses, or null if it never does.
keyobjectThe calling key: its id and name, request and concurrency limits, spend quota, the models it is allowed to call (empty means all), and expiry. null means no limit.