Create a response (OpenAI Responses shape)
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.
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.
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
Header Parameters
Opaque, caller-chosen key that makes a retry safe. The OpenAI SDK — the integration path ModelBeat advertises — retries 5xx and timeouts by default; without this header each retry is a new logical request, i.e. a second reservation and a second charge for one prompt. Send the same key on a retry and ModelBeat returns the original reservation: one hold, one charge.
Reusing a key for a different request body, or one whose reservation was already settled,
is refused with 409. Keys longer than 255 characters are ignored (treated as absent).
length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/responses" \ -H "Idempotency-Key: req-8f3a1c00-2b7e-4d9a-9c11-000000000000" \ -H "Content-Type: application/json" \ -d '{ "model": "auto", "input": "string" }'{}Create embeddings POST
OpenAI-compatible embeddings. Real inference — a provider is called and paid for this request — but this path is **not metered by ModelBeat**: no balance hold is taken, no `usage.cost` is attached, and the call does not appear in usage history. Do not build a production integration that depends on this endpoint's cost or usage being tracked.
Get the prepaid balance GET
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.