List the intelligence tiers
Lists the values `model` accepts, in the OpenAI `/v1/models` list shape, so a stock OpenAI SDK's `models.list()` works unchanged. Authenticated and rate-limited like every `/v1` path, but never metered — no balance hold is taken. During the private beta this is a tier list, not a model catalogue: it returns `modelbeat-advanced`, `modelbeat-standard` and `modelbeat-fast`, and never a model id. Tier names are ModelBeat's own abstraction over the pool, so listing them discloses no model identity (ADR-0070).
Lists the values model accepts, in the OpenAI /v1/models list shape, so a stock
OpenAI SDK's models.list() works unchanged. Authenticated and rate-limited like
every /v1 path, but never metered — no balance hold is taken.
During the private beta this is a tier list, not a model catalogue: it returns
modelbeat-advanced, modelbeat-standard and modelbeat-fast, and never a model
id. Tier names are ModelBeat's own abstraction over the pool, so listing them
discloses no model identity (ADR-0070).
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/models"{ "object": "list", "data": [ { "id": "auto", "object": "model", "created": 0, "owned_by": "modelbeat", "context_length": 0, "max_completion_tokens": 0 } ]}Get an aggregate spend/usage summary GET
Account-level aggregate — total spend, request count, and token count over a date window — merged server-side with a balance snapshot. Authenticated and rate-limited like every `/v1` path, but never metered. Omit both `from` and `to` and the window defaults to the trailing 30 days; the response always echoes back the window actually queried, defaulted or not. For a per-request list instead of an aggregate, see `GET /requests`.
List past requests GET
Paginated, per-request usage history — an OpenAI-style list envelope. Authenticated and rate-limited like every `/v1` path, but never metered. Omit both `from` and `to` and the window defaults to the trailing 30 days, echoed back in the response the same way `GET /usage` does. For a single request by id, see `GET /requests/{id}`.