Smart Router · Coding agents

Aider with the AI Stupid Level Smart Router

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.

Get a free router key

1,000 routed requests a month free · your own provider keys · no card

Part of Smart Router integrations · About the Smart Router · Help centre

ShellShell
export OPENAI_API_BASE=https://aistupidlevel.info/v1
export OPENAI_API_KEY=aism_your_key_here
aider --model openai/auto-coding

01

What Aider gets from the Smart Router

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.

Routing on benchmark results
A routing mode as the model name sends each request to the model placing highest on the relevant board — coding, reasoning or tool use — ranked on the average of its last five benchmark runs, never a single run. Statistically tied leaders are split by your tie-break preference, the cheaper measured cost per task by default. Drift-aware routing moves a model whose drift detector has fired for that skill behind every unflagged model.
Your own provider keys
You pay OpenAI, Anthropic, Google, DeepSeek, Moonshot AI (Kimi) or Z.ai (GLM) directly for tokens. Provider keys are encrypted at rest (AES-256-GCM) and never shown again.
No token markup
The router adds nothing to token prices. Free includes 1,000 routed requests a month, and only successful requests count.
The model that answered, every time
Every response carries 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

How to set up Aider with the Smart Router

Every value below is the one in the router documentation; paste it as shown.

  1. Create a router key

    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.

  2. Add your provider keys

    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.

  3. Export the two variables and start Aider

    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.

    ShellShell
    # 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
  4. Optional: tell Aider the router’s limits

    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.

    .aider.model.metadata.jsonJSON
    {
      "openai/auto-coding": {
        "max_input_tokens": 262144,
        "max_output_tokens": 64000,
        "litellm_provider": "openai",
        "mode": "chat"
      }
    }

03

Which routing mode should Aider use?

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-coding
Coding. Best for code generation, debugging, refactoring.Top of the Coding board in the last 24 hours: DeepSeek V4.1 Flash, in a statistical tie for first place, of 22 ranked models.
auto-value-coding
Value. Most coding points per dollar (measured cost of a coding run), near-top models only.
auto-best
Overall. Best combined score regardless of category; among statistically tied leaders, your tie-break decides (the cheaper by default).Top of the Combined board in the last 24 hours: DeepSeek V4.1 Flash, in a statistical tie for first place, of 22 ranked models.

24-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

What Aider supports behind the router

  • The model takes the openai/ prefix: aider --model openai/auto-coding. Any routing mode or real model id works after the prefix.
  • Limits for the metadata file: 262,144 input tokens and 64,000 output tokens per request on the routing modes.
  • Streaming is real: text arrives as the model writes it (X-AISM-Streaming-Mode: native).
  • Text only: a request with images, audio or files gets a 400 unsupported_content.

05

Aider not working with the router?

The errors a tool shows, with the fix from the docs’ error table and the help centre.

401 invalid_api_key
Missing or invalid 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.
400 model_not_found
An unknown 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.
No models in the dropdown
The tool fills its list from 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.
400 provider_key_rejected or no_provider_keys
Your provider key is missing or was refused. Add or update it under Providers, re-check it on the provider’s dashboard, and make sure it has active credits and the right permissions.
Streaming
Set 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.
400 unsupported_content
The router routes text only, on purpose: it picks a model from benchmark results for coding, reasoning and tool use, and none of those measure image, audio or file understanding. Send such requests to the provider directly.
429 allowance_exhausted
This month’s requests are used up and you have no prepaid credits. Credits top up the allowance; moving up a plan is the cheaper way to buy regular volume.

06

Questions about Aider and the Smart Router

Why openai/ in front of the model?

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.

Do I need .aider.model.metadata.json?

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.

Does this cost extra?

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.

Which mode gives the cheapest good answers?

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.

Can I pin one model?

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

Other tools that work with the Smart Router

Every tool takes the same base URL and key. The integrations hub lists them all; the docs add samples for frameworks and SDKs.

Connect Aider in a few minutes

A free account gives you a router key, the Providers page for your own keys, and the request allowance. No card.

Get a free router key

1,000 routed requests a month free · your own provider keys · no card