Models

minirouter currently supports 208 language models. List them from the API, copy the ID you need, or provide an ordered set of fallback models.

Model IDs

Model IDs use author/name format. Copy them exactly as returned by the API. Examples: alibaba/qwen-3-14b, alibaba/qwen-3-235b, alibaba/qwen-3-30b.

OpenAI-shaped model list
curl https://api.minirouter.sh/v1/models \
  -H "Authorization: Bearer $MINIROUTER_KEY"

Browse and copy the same IDs on /models.

Client-compatible catalog

GET /api/v1/models is public. It returns each model’s context window, modalities and current minirouter price. Cline, Roo Code, Kilo Code and SillyTavern can use it to fill their model pickers.

Catalog shape
{
  "data": [
    {
      "id": "alibaba/qwen-3-14b",
      "name": "Qwen3-14B",
      "context_length": 40960,
      "architecture": {
        "modality": "text->text",
        "input_modalities": [
          "text"
        ],
        "output_modalities": [
          "text"
        ]
      },
      "pricing": {
        "prompt": "0.000000126",
        "completion": "0.000000252",
        "request": "0",
        "image": "0"
      },
      "top_provider": {
        "context_length": 40960,
        "max_completion_tokens": 16384
      }
    }
  ]
}

Fallback models

Send models with an ordered list of acceptable fallback IDs. minirouter never chooses a model outside that list.

Request with fallback models
{
  "model": "alibaba/qwen-3-14b",
  "messages": [
    {
      "role": "user",
      "content": "ping"
    }
  ],
  "models": [
    "alibaba/qwen-3-14b",
    "alibaba/qwen-3-235b"
  ]
}

Unsupported model types

minirouter currently serves text-generation models. Image, video, speech, transcription, embedding, reranking and realtime requests are not supported.

When an ID is wrong

An unavailable ID returns 404 unknown_model with a did-you-mean suggestion and a link to the current list.