Skip to content
OneAPIDocs
ModelsOpen console

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.

GEThttps://api.oneapi.id/v1/me
Key header
Authorization: Bearer or x-api-key
Body
None
Cost
Free, not billed

Request

curl https://api.oneapi.id/v1/me \
  -H "Authorization: Bearer $ONEAPI_API_KEY"

Response

200 OK
{
  "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.

statusstring

active, or frozen when the account is suspended and cannot make requests.

balance_usdstring

The account balance.

available_usdstring

What 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_usdstring

Free 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_modelsboolean

true for credit that works on any model but expires.

model_credits[].remaining_usdstring

What is left of amount_usd.

model_credits[].expires_atstring | null

RFC 3339 time the credit lapses, or null if it never does.

keyobject

The 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.