Let the gateway pick
Send minirouter/auto and the gateway picks the model. The x-minirouter-model header names the one that answered.
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":"ping"}]}'
# x-minirouter-model: <the model that answered>How the pick is made
- 1
IntentAdd a suffix to choose a list yourself:
:cheap,:code,:roleplay. Only the request shape is read, never the prompt.Bare Auto is Smart. Tools or structured output select Code.
- 2
Walk the listEach list is hand-ordered and changes only by a reviewed code change. Not combinable with your own providerOptions.gateway.models fallback list.
Best first, in the order shown below.
- 3
Skip what failsTools, structured output and long prompts can push a candidate over the price bound for your exact request.
Catalog, allowlist, cost tier, route health, price bound.
- 4
AnswerOne worst-case hold covers the eligible set. A failure before output tries the next candidate on Chat Completions and Responses.
The first pass answers.
x-minirouter-modelnames it.
Nothing passes: 503 auto_unresolvable, uncharged.
Current candidates
Platform availability before your account rules and request shape apply.
Raw table: /api/v1/auto · refreshed every minute
SmartDefault
minirouter/auto:smartA strong general-purpose model at a mid-range price.
| # | Model | Input $/M | Output $/M | Context | Providers | Status |
|---|---|---|---|---|---|---|
| 1 | zai/glm-5.3-flash | $0.158 | $0.525 | 1M | — | Skipped · no healthy route |
| 2 | openai/gpt-5.6-sol | $2.10 | $10.50 | 1.1M | vercel | First available |
| 3 | spacexai/grok-4.6 | $2.10 | $6.30 | 500K | vercel | Next in line |
| 4 | google/gemini-3.8-flash | $0.788 | $3.94 | 1M | vercel | Next in line |
| 5 | openai/gpt-5.6-luna | $0.21 | $1.26 | 1.1M | vercel | Next in line |
Cheap
minirouter/auto:cheapThe least expensive model that still answers well.
| # | Model | Input $/M | Output $/M | Context | Providers | Status |
|---|---|---|---|---|---|---|
| 1 | xiaomi/mimo-v2.5 | $0.147 | $0.294 | 1.1M | vercel | First available |
| 2 | xiaomi/mimo-v2.5-pro | $0.457 | $0.914 | 1.1M | vercel | Next in line |
| 3 | tencent/hy3 | $0.147 | $0.609 | 262K | vercel | Next in line |
| 4 | deepseek/deepseek-v4-flash-0731 | $0.08 | $0.161 | 1M | vercel | Next in line |
| 5 | zai/glm-5.3-flash | $0.158 | $0.525 | 1M | — | Skipped · no healthy route |
Code
minirouter/auto:codeA model with dependable tool calling and long context for coding agents.
| # | Model | Input $/M | Output $/M | Context | Providers | Status |
|---|---|---|---|---|---|---|
| 1 | zai/glm-5.3-flash | $0.158 | $0.525 | 1M | — | Skipped · no healthy route |
| 2 | openai/gpt-5.6-sol | $2.10 | $10.50 | 1.1M | vercel | First available |
| 3 | spacexai/grok-4.6 | $2.10 | $6.30 | 500K | vercel | Next in line |
| 4 | google/gemini-3.8-flash | $0.788 | $3.94 | 1M | vercel | Next in line |
| 5 | openai/gpt-5.6-luna | $0.21 | $1.26 | 1.1M | vercel | Next in line |
Roleplay
minirouter/auto:roleplayA high-intelligence, long-context model with low input cost for repeatedly sent conversations.
| # | Model | Input $/M | Output $/M | Context | Providers | Status |
|---|---|---|---|---|---|---|
| 1 | zai/glm-5.3-flash | $0.158 | $0.525 | 1M | — | Skipped · no healthy route |
| 2 | openai/gpt-5.6-luna | $0.21 | $1.26 | 1.1M | vercel | First available |
| 3 | deepseek/deepseek-v4-flash-0731 | $0.08 | $0.161 | 1M | vercel | Next in line |
| 4 | google/gemini-3.8-flash | $0.788 | $3.94 | 1M | vercel | Next in line |
Your account rules
Set once on Routing. Every key on the account follows them.
Cost tierCaps the output price per million tokens of any candidate Auto may pick. Not a request budget. An explicit intent keeps its list under the same cap.
Low
$1
per M output tokens
Bare Auto starts from Cheap.
Medium
$5
per M output tokens
Bare Auto starts from Smart.
High
No cap
the default
Bare Auto starts from Smart.
Allowed modelsApplies to requests that name a model too. Adding a model here does not add it to Auto's lists.
Exact IDs or
openai/*. Keys can narrow it, requests cannot widen it.Prevent overridesResponds with
x-minirouter-overrides: ignored. Allowed models and the cost tier apply either way.Ignores a request’s
providerOptions.gateway.Provider sortA sort set on the request wins unless Prevent overrides is on.
Balanced, price, latency or throughput. Orders providers, not models.
Default modelAuto, an intent, or any catalog model. A model named on the request is left as sent. Dashboard chat uses its own picker.
What integration keys get when
modelis omitted.