Models & routing

Auto router

Send minirouter/auto and MiniRouter picks the model.

Send a requestExamples read your key from MINIROUTER_KEY.

Auto request
curl https://api.minirouter.sh/v1/chat/completions \
  -H "Authorization: Bearer $MINIROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minirouter/auto",
  "messages": [
    {
      "role": "user",
      "content": "Explain an API gateway in one sentence."
    }
  ],
  "max_tokens": 256
}'

Intents

Model IDPicks
minirouter/auto:smart, or :code when the request has tools or JSON output.
minirouter/auto:smartA strong general model at a mid-range price.
minirouter/auto:cheapThe cheapest model that still answers well.
minirouter/auto:codeReliable tool calling and long context.
minirouter/auto:roleplayLong context with low input cost.
minirouter/auto:freeFree models only. See Auto Free.

To choose from what the request says, send minirouter/fusion.

Every router has its own page, starting with Auto.

How it choosesLater models in the list become fallbacks. Auto never reads prompt text.

  1. 01AllowedOn your key.
  2. 02AffordableWithin your cost tier.
  3. 03HealthyHas a working provider.
  4. 04FitsCan accept this request.

The first model to pass answers. See the live lists at Auto models.

Cost tierOutput price ceiling per million tokens. On Low, bare minirouter/auto starts from :cheap.

Low
$1
Medium
$5
High, the default
Any

Set it in Routing settings.

Response

  • Chosen modelNamed in model and x-minirouter-model.
  • PriceProvider cost plus 8%.
  • No match503 auto_unresolvable. Retry after 15 seconds.

Limits

LimitDetail
EndpointsChat Completions, Responses and Messages.
Fallback listsNot combinable with models or fallbacks.