Get credit balance
Returns the team’s credit balance broken down into total credits, held_credits (locked against pending generations on a charge-on-success basis), and available_credits = credits − held_credits. POST /v1/images and POST /v1/videos check against available_credits and return 402 invalid_request / balance_too_low if insufficient. Holds are released back to the available balance when a generation fails or is cancelled; they commit (debiting credits) when a generation succeeds. The response also includes billing_mode: when it is exempt, do NOT gate on balance — generations are never blocked and the numeric fields never decrement. Treat billing_mode as an open enum (unknown ⇒ non-gating).
Authorizations
Your team API key (starts with al_live_).
Headers
Optional API version pin (YYYY-MM-DD). Defaults to your team's pinned version, or the system default 2026-05-15 for unauthenticated requests.
^\d{4}-\d{2}-\d{2}$"2026-05-15"
Response
Current credit balance trio
Total credits on the team (sum of available + held).
1023.49
Credits currently held against pending generations (charge-on-success). Released back to the available balance when the generation fails or is cancelled.
4
Spendable balance — credits − held_credits. New POST /v1/images checks against this value and returns 402 invalid_request / balance_too_low if insufficient.
1019.49
Currency identifier; always "credit" today. Reserved for future fiat reporting.
credit "credit"
Billing mode. Known values: "metered" (default) — generations are charged and gated on available_credits; "exempt" — the team is never charged and never blocked, and the numeric fields above stay real but never decrement or gate. OPEN enum, typed as a plain string: new modes may be added, so treat any unrecognized value as non-gating (do not hard-code a closed set).
"metered"