Smart Router · Coding agents
Two environment variables and a model flag put Aider on benchmark-routed models: OPENAI_API_BASE, OPENAI_API_KEY and --model openai/auto-coding, with your own provider keys and no token markup.
1,000 routed requests a month free · your own provider keys · no card
Part of Smart Router integrations · About the Smart Router · Help centre
export OPENAI_API_BASE=https://aistupidlevel.info/v1 export OPENAI_API_KEY=aism_your_key_here aider --model openai/auto-coding
01
Two environment variables and a model flag put Aider on benchmark-routed models: OPENAI_API_BASE, OPENAI_API_KEY and --model openai/auto-coding, with your own provider keys and no token markup.
X-AISM-Model and X-AISM-Reasoning: which model answered and why, including any fallback. If the chosen model fails before answering, the router tries your own fallback order, then up to 2 automatic fallbacks from different providers.02
Every value below is the one in the router documentation; paste it as shown.
Go to API keys, click Create key and copy it somewhere safe. The key starts with aism_ and is the one key for every tool you connect.
Under Providers, add keys for OpenAI, Anthropic, Google, DeepSeek, Kimi or GLM. The more providers you add, the better the routing. You pay them directly for tokens; the router adds nothing to token prices, and provider keys are encrypted at rest (AES-256-GCM) and never shown again.
Aider works with any OpenAI-compatible API. OPENAI_API_BASE is the router, OPENAI_API_KEY is your aism_ key, and the model is a routing mode with the openai/ prefix, which tells Aider to use the OpenAI chat format.
# Aider works with any OpenAI-compatible API export OPENAI_API_BASE=https://aistupidlevel.info/v1 export OPENAI_API_KEY=aism_your_key_here aider --model openai/auto-coding
A .aider.model.metadata.json next to your project gives Aider the routing mode’s context and output limits, so its own accounting matches the router.
{
"openai/auto-coding": {
"max_input_tokens": 262144,
"max_output_tokens": 64000,
"litellm_provider": "openai",
"mode": "chat"
}
}03
A routing mode goes where the tool asks for a model name. The quality modes read the same scores the leaderboard shows; the value modes choose among models within 5 points of the best and take the lowest measured cost per run. Every mode is described in the Virtual models section of the docs.
auto-codingauto-value-codingauto-best24-hour boards as of 26 Oct 2026, 10:51 UTC · places follow the leaderboard’s statistical ties · the full leaderboard
Any real model id from GET /v1/models pins that model and bypasses routing; your plan allowance and key budgets still apply. Unknown auto-* names get a 400 model_not_found that lists the valid ones.
04
openai/ prefix: aider --model openai/auto-coding. Any routing mode or real model id works after the prefix.X-AISM-Streaming-Mode: native).400 unsupported_content.05
The errors a tool shows, with the fix from the docs’ error table and the help centre.
aism_ key. Check the key is correct and not revoked, and that the tool sends it as Authorization: Bearer aism_…. If a field insists on an sk- prefix, sk-aism_… is accepted: the prefix is stripped automatically. A key that had an expiry date and passed it gets 401 expired_api_key, and the message says when.auto-* name is a 400 that lists the valid routing modes. For a real model id, check the spelling: direct pin routing infers the provider from the model name prefix, and GET /v1/models lists every id you can use.GET /v1/models, which requires a valid aism_ key. Check that the key and the base URL https://aistupidlevel.info/v1 are both in place.stream: true. Text arrives as the model writes it (X-AISM-Streaming-Mode: native); tool calls arrive in one chunk each once the model has finished them, then the finish reason, then usage if you set stream_options.include_usage. If the chosen model fails before sending anything, or its provider sends nothing for 120 seconds, the next fallback is tried.06
Aider works with any OpenAI-compatible API; the openai/ prefix tells it which API format to speak, and everything after it is sent to the router as the model. openai/auto-coding routes; openai/ followed by a real model id pins that model.
It is optional. The file tells Aider the routing mode’s limits, 262,144 input tokens and 64,000 output tokens, with litellm_provider set to openai and mode to chat, so Aider’s own token accounting matches what the router accepts.
No. You pay the providers directly for tokens, with your own keys; the router adds nothing to token prices. The Free plan includes 1,000 routed requests a month (Pro Intelligence 10,000, Developer 100,000, Teams 1,000,000), and prepaid credits cover any beyond that at $5 per 10,000. Only successful requests count. No card for the Free plan.
auto-value-coding: the most coding points per dollar among models within 5 points of the best one you can use, on the measured cost of a coding run rather than list price. auto-coding is the quality pick for code generation, debugging and refactoring.
Yes. Send any real model id after the prefix, for example openai/ plus an id from GET /v1/models; the router forwards directly to that provider, and your plan allowance and key budgets still apply.
07
Every tool takes the same base URL and key. The integrations hub lists them all; the docs add samples for frameworks and SDKs.
A free account gives you a router key, the Providers page for your own keys, and the request allowance. No card.
1,000 routed requests a month free · your own provider keys · no card