Build

Models

microrouter currently serves 240 language models. List them from the API, copy the ID you need, or provide an ordered set of fallbacks.

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://microrouter.xyz/v1/models \
  -H "Authorization: Bearer $MICROROUTER_KEY"

Browse and copy the same IDs on /models.

Client-compatible catalog

GET /api/v1/modelsis public. It returns each model’s context window, modalities and current microrouter 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. microrouter 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

microrouter 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.