Aider + minirouter

Draft environment-variable and model-flag configuration for the Aider terminal client.

Base URLhttps://api.minirouter.sh/v1
Get a keyhttps://minirouter.sh/key
Get a key — no account

Settings

Environment variables + command line

In order

  1. OPENAI_API_BASEhttps://api.minirouter.sh/v1
  2. OPENAI_API_KEYmr-live-… (your key)
  3. --modelopenai/meta/llama-3.3-70b

    The openai/ prefix tells Aider to use the OpenAI-compatible endpoint; everything after it is our model id.

Shell — unverified draft
export OPENAI_API_BASE=https://api.minirouter.sh/v1
export OPENAI_API_KEY=mr-live-YOUR-KEY-HERE
aider --model openai/meta/llama-3.3-70b

Draft candidates · 4 models

All models →

Only rows confirmed in the current live catalog are linked. A plain row is a draft recommendation, not a claim that the model is currently available. Paste ids exactly as written, author/name.

When it fails

  • SymptomAider warns the model is unknown and guesses a context window
    Codeclient-side

    Expected for custom endpoints — Aider's local metadata does not know our ids. The warning is cosmetic; requests still work.

  • Symptom404, HTML, or a parse error on every request
    Codeinvalid_request

    Almost always the base URL. Use https://api.minirouter.sh/v1 — the bare host without /v1 also works, but never append /chat/completions to the base URL field; the client adds that path itself. docs/errors#invalid_request

  • Symptom401 on every request
    Codeinvalid_api_key

    Wrong or rotated key. Keys start with mr-live-; after a rotation the old key keeps working for 24 hours, then dies. docs/errors#invalid_api_key

  • Symptom402 before any tokens arrive
    Codeinsufficient_credits

    Balance below the estimated cost of the request. Top up ($5 minimum) — and watch the x-minirouter-balance-usd header, the low-balance signal every response carries. docs/errors#insufficient_credits

Every API error string carries a URL resolving to /docs/errors.

Other coding agents and editors

Agent setup: /setup · API reference: /docs