List models

Base URL: https://api.orbitrage.ai/v1 · Auth: Authorization: Bearer orb_…

GET /v1/models

Returns the models currently routable on your account, in OpenAI list format with extra fields for tier, vision support, routing bias, and access mode. This is the authoritative catalog — it reflects which providers are configured and any BYOK keys you’ve saved.

Example

curl https://api.orbitrage.ai/v1/models \
  -H "Authorization: Bearer $ORBITRAGE_API_KEY"

Response

{
  "object": "list",
  "data": [
    {
      "id": "DeepSeek-V4-Flash",
      "object": "model",
      "tier": "mid",
      "vision": false,
      "bias": "mixed",
      "byok_required": false,
      "byok_ready": true
    },
    {
      "id": "claude-sonnet-4-6",
      "object": "model",
      "tier": "frontier",
      "vision": true,
      "bias": "mixed",
      "byok_required": true,
      "byok_provider": "anthropic",
      "byok_ready": false
    }
  ]
}

Field	Meaning
`id`	The model id you pass in `model` to pin it.
`tier`	`basic`, `mid`, `high`, `frontier`, or `image`. See Routing.
`vision`	Whether the model accepts image content.
`bias`	Routing hint: `chat`, `code`, `mixed`, or `reasoning`.
`byok_required`	`true` for closed-weight frontier chat models — they run only on your own provider key, and Orbitrage bills $0 for their tokens.
`byok_provider`	Present when `byok_required` — the vendor whose key you need (`openai`, `anthropic`, `google`, `xai`).
`byok_ready`	Whether this model is callable right now on your org. `false` on a `byok_required` model means you haven’t saved and enabled that vendor’s key yet; calling it returns `403 byok_key_required`.

Use this endpoint to populate a model picker, or to discover the exact ids to pin. Filter on byok_ready to show only what your organization can call today, and use byok_required to render a “BYOK” badge and an Add key link for the rest. For pricing per model, see Models.

Overview

Endpoints

Example

Response

​Example

​Response

Example

Response