Models API

AnyRouter exposes the model catalog via REST. Every model is uniquely identified by a provider/model slug — the same format used in the chat completions model field.

The JSON list is GET /api/v1/models (or https://api.anyrouter.dev/api/v1/models). Use that path when you need JSON — some hosts serve HTML on other /models URLs.

Request

List models

Returns models the current caller can reach — platform routes, matching BYOK keys, and (when you send an LLM API key) that key's allow/deny lists. Anonymous requests omit BYOK-only rows such as Anthropic Sonnet. Pass all=1 or include=unavailable for the full catalog, including models you cannot call yet.

Accepts these query parameters:

Get one model

GET /api/v1/models/{owner}/{model} — use the catalog slug as two path segments. For anthropic/claude-sonnet-4-6, request /api/v1/models/anthropic/claude-sonnet-4-6. Nested routes on the same id (/routing-preview, /metrics, /privacy, /uptime) accept that slash form too. The single-segment encoded form (anthropic%2Fclaude-sonnet-4-6) still works.

Platform auto-routing presets (anyrouter/auto, anyrouter/free, and the other first-party anyrouter/* ids) expose their live failover chain at GET /api/v1/models/anyrouter/auto/routing-preview (no auth for platform presets). The unique member list is the same order inference will try.

Count

GET /api/v1/models/count returns a lightweight JSON object with the current model count — useful for health checks and cache warming.

Response

{
  "object": "list",
  "data": [
    {
      "id": "openai/gpt-5.4-mini",
      "object": "model",
      "provider": "OpenAI",
      "providers": ["OpenAI", "Groq"],
      "category": "text",
      "context_length": 128000,
      "pricing": {
        "prompt": "10",
        "completion": "30",
        "input_per_1m": 10,
        "output_per_1m": 30
      },
      "capabilities": ["chat", "function-calling", "vision"],
      "links": {
        "details": "/api/v1/models/openai/gpt-4-turbo",
        "metrics": "/api/v1/models/openai%2Fgpt-4-turbo/metrics"
      }
    }
  ]
}

provider is the organization that owns the model. providers lists the public upstream providers that can serve it.

BYOK pricing

When every route for a model is BYOK, AnyRouter charges $0 and your own provider bills you. Those models carry pricing.billing: "byok" and, when the provider's published rate is known, pricing.list_pricing (input_per_1m, output_per_1m). Each per_upstream entry priced at 0 only because it is BYOK also carries billing: "byok", plus list_pricing when published. Treat 0 on those routes as "billed by your provider", not free.

Reasoning and output limits

The model response exposes only facts present in the catalog:

• reasoning.levels and reasoning.default are the exact model-level effort enum when the model declares one. The field is omitted when no enum is declared; clients must not invent a level list.
• per_upstream[].reasoning is a route-specific effort override. If it is omitted, the route inherits the model-level enum. per_upstream[].features.reasoning is a capability flag, not an effort list.
• supported_parameters remains authoritative. For a selected route, use per_upstream[].supported_parameters; the top-level field is a model-level/legacy projection and is not a promise shared by every fallback route. The API does not add a reasoning parameter because a model advertises reasoning.
• top_provider.max_completion_tokens is the strictest completion cap declared by any serving upstream, or null when no upstream declares one. It is not a promise that an undeclared route is unlimited. Per-route caps are available at per_upstream[].context.max_completion_tokens.
• AnyRouter does not infer universal toggle, token-budget, or interleaved-thinking support from a model name or description. Toggle and budget controls remain endpoint-specific (reasoning.enabled / reasoning.max_tokens on Responses, thinking on Messages). Anthropic interleaved thinking is a provider beta request (anthropic-beta: interleaved-thinking-2025-05-14), not a model or preset capability flag; whether the selected provider honors it is provider-specific.

Your presets in the response

When the request is authenticated, the response also includes a presets array of your account's saved presets alongside data. This lets a model picker show your presets next to raw models in a single call:

{
  "object": "list",
  "data": [ /* … models … */ ],
  "presets": [
    {
      "id": "preset_abc123",
      "object": "preset",
      "slug": "code-reviewer",
      "name": "Code Reviewer",
      "description": "Strict senior-engineer review.",
      "config": { "model": "anthropic/claude-sonnet-4-6", "temperature": 0.2 },
      "created_at": "2026-03-01T12:00:00Z",
      "updated_at": "2026-03-01T12:00:00Z"
    }
  ]
}

The field is omitted entirely for unauthenticated requests. Pass ?presets=0 to skip it on an authenticated request. Reference a preset in any inference call with the @preset/<slug> model syntax.

List providers

GET /api/v1/providers lists the upstream backends AnyRouter dispatches to:

{
  "object": "list",
  "data": [
    {
      "id": "openai",
      "name": "OpenAI",
      "description": "GPT models",
      "website": "https://openai.com",
      "status": "operational",
      "model_count": 4,
      "regions": ["us", "eu"],
      "model_prefix": "openai/",
      "endpoints": ["/api/v1/chat/completions", "/api/v1/responses", "/api/v1/models"]
    }
  ]
}

Examples

# Models you can call without a key (anonymous). Use the api. host if apex returns HTML.
curl https://api.anyrouter.dev/api/v1/models

# Full catalog, including BYOK-only rows
curl "https://api.anyrouter.dev/api/v1/models?all=1"

# Models reachable with this LLM API key
curl https://anyrouter.dev/api/v1/models \
  -H "Authorization: Bearer sk-ar-your-key"

# Filter + newest first
curl "https://anyrouter.dev/api/v1/models?provider=anthropic&min_context=200000&sort=added" \
  -H "Authorization: Bearer sk-ar-your-key"

# Top usage this week
curl "https://anyrouter.dev/api/v1/models?sort=usage"

# One model (slash path)
curl https://anyrouter.dev/api/v1/models/anthropic/claude-sonnet-4-6 \
  -H "Authorization: Bearer sk-ar-your-key"

# Live failover chain for a platform preset (slash path; %2F also works)
curl https://anyrouter.dev/api/v1/models/anyrouter/auto/routing-preview

# List providers (no auth required)
curl https://anyrouter.dev/api/v1/providers

import requests

resp = requests.get(
    "https://anyrouter.dev/api/v1/models",
    params={"provider": "anthropic", "min_context": 200000},
    headers={"Authorization": "Bearer sk-ar-your-key"},
)
for model in resp.json()["data"]:
    print(model["id"], model["context_length"])

const res = await fetch(
  "https://anyrouter.dev/api/v1/models?provider=anthropic&min_context=200000",
  { headers: { Authorization: "Bearer sk-ar-your-key" } },
)
const { data } = await res.json()
data.forEach((m: { id: string; context_length: number }) =>
  console.log(m.id, m.context_length),
)

Errors

See Errors for the full status table.