Get the prepaid balance
A standalone, point-in-time balance check — the full breakdown (held, purchased, bonus, signup offer), for a "do I have enough money to fire this batch right now" check before a caller submits a large amount of work. Authenticated and rate-limited like every `/v1` path, but never metered — no balance hold is taken.
A standalone, point-in-time balance check — the full breakdown (held, purchased,
bonus, signup offer), for a "do I have enough money to fire this batch right now"
check before a caller submits a large amount of work. Authenticated and
rate-limited like every /v1 path, but never metered — no balance hold is taken.
Authorization
bearerAuth A ModelBeat API key, prefixed mb_live_, sent as Authorization: Bearer <key>.
Keys are issued in the ModelBeat console and are scoped to one tenant. The
example value used throughout this document
(mb_live_EXAMPLE_NOT_A_REAL_KEY_00000000000000000000) is a placeholder and
will not authenticate.
In: header
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/balance"{ "balance": { "amount": "37.14000000", "currency": "USD" }, "held": { "amount": "37.14000000", "currency": "USD" }, "available": { "amount": "37.14000000", "currency": "USD" }, "purchased": { "amount": "37.14000000", "currency": "USD" }, "bonus": { "amount": "37.14000000", "currency": "USD" }, "signup_offer_available": true}Create a response (OpenAI Responses shape) POST
OpenAI Responses API-compatible endpoint. Same routing/billing semantics as `/chat/completions` and `/messages` — a different wire format for the same catalog-driven model pool.
Get a single past request GET
Look up one request by id. Authenticated and rate-limited like every `/v1` path, but never metered. **`id` must be the `X-Request-Id` response header value from the original request, not the response body's own `id` field.** Same identifier convention as `POST /feedback`.