Models

Endpoint

GET /v1/models

Lists the capability tiers you can pass as model to the Answers API and the Agent API. OpenAI-compatible shape.

Note

Public — the model catalog is a static capability list (no tenant data), so this endpoint needs no API key. An Authorization header, if sent (the OpenAI SDKs always attach one), is ignored. Every other /v1 endpoint requires Authorization: Bearer mb_live_*.

Tiers

model	Tier	Use case
mirobody-flash	Default — fast, low cost	Everyday health Q&A, high concurrency
mirobody-expert	Deeper reasoning	Complex report interpretation, multi-step analysis

Hosted model usage is metered from the backing provider’s token counts. Each model response includes usage.billed_tokens; combine those counts with the current catalog’s pricing to estimate cost. The console Usage page reports request counts, not token-level cost. The open-source engine is free software — self-host it and you pay only for your own infrastructure and LLM providers.

Per-tier metadata

Each entry carries a conservative capacity budget and the per-tier price:

Field	Meaning
context_window	Advertised input-plus-output capacity for the tier. Treat it as a planning budget, not a promise that every request shape will fit.
max_output_tokens	Advertised output capacity — catalog metadata only; agent mode does not enforce request fields such as max_tokens.
pricing	{input_per_1m_tokens, output_per_1m_tokens, currency} — standard price per 1M tokens for estimating from usage.billed_tokens. Cache adjustments are not represented in this object.

Example

# no API key needed
curl https://api.mirobody.ai/v1/models

from openai import OpenAI

# api_key is unused by /v1/models but the SDK requires the field to be set
client = OpenAI(api_key="unused", base_url="https://api.mirobody.ai/v1")
for m in client.models.list().data:
    print(m.id)

Response

An OpenAI-style { "object": "list", "data": [ … ] } — each tier extends the standard model object with context_window, max_output_tokens, and pricing. The values below illustrate the response shape; read the live endpoint for current values:

{
  "object": "list",
  "data": [
    { "id": "mirobody-flash", "object": "model", "owned_by": "mirobody",
      "context_window": 65536, "max_output_tokens": 8192,
      "pricing": { "input_per_1m_tokens": 0.75, "output_per_1m_tokens": 4.50, "currency": "USD" } },
    { "id": "mirobody-expert", "object": "model", "owned_by": "mirobody",
      "context_window": 65536, "max_output_tokens": 8192,
      "pricing": { "input_per_1m_tokens": 5.0, "output_per_1m_tokens": 25.0, "currency": "USD" } }
  ]
}

Note

Capacity, backing providers, and pricing may differ by cluster and can change without changing the stable tier id. Always read pricing from the cluster you call rather than hard-coding the example.

Always pass a stable tier as model — mirobody-flash (default) or mirobody-expert.