Skip to content
FluxCDNFluxCDN
esc
On this page

DocsTools guide

Aider with FluxCDN AI

Aider works next to git in the terminal, writes changes straight into your files and commits them. It doesn't need tool calling, so almost any chat model in our catalog can drive it.

Licence:
Apache-2.0, open source
Platforms:
macOS, Linux, Windows (Python 3.10 to 3.12)
Address (OpenAI-compatible):
https://ai.fluxcdn.cloud/api/v1
The tool's own docs ↗

Before you start

  • Create an API key. On the API keys page press “Create key” and copy the key right away. It starts with flux_live_ and is never shown in full again.
  • Give agents a key of their own and set a daily or monthly spending limit on it with “Limits”. Agents send request after request by themselves; the limit stops spending you didn't expect.
  • Have some credit in the account (Billing).
  • In the examples, put your own key where it says flux_live_YOUR_KEY.

Set it up

  1. Step 1: Pick a model setup and save the settings

    The simplest place is .aider.conf.yml in your home folder. Don't put it in the project folder, so the key isn't committed with the code. Put openai/ before the model id: Aider (through LiteLLM) removes the first part and sends the rest to FluxCDN. weak-model writes commit messages and summaries.

    Pick a setup; the settings below change with it. Any id from the models page works in their place too.

    Price per million tokens. Free plan prices, in Toman at today's rate. Routers (router/auto and the like) are not recommended for agents: an agent needs a model that is sure to support tools.

    ~/.aider.conf.yml
    openai-api-base: https://ai.fluxcdn.cloud/api/v1
    openai-api-key: flux_live_YOUR_KEY
    model: openai/anthropic/claude-sonnet-5.5
    weak-model: openai/anthropic/claude-haiku-5.5

    The “model metadata” tab is optional: it tells Aider the model's real size so it stops warning “Unknown context window”. The cost is set to zero; see the real cost under Activity.

  2. Step 2: Start Aider

    Run aider in your project folder (a git repository) and add the files to change to the chat.

    Terminal
    cd your-project
    aider

Check it works

  1. Step 1: Send one message and exit

    Aider sends one message, prints the answer and exits.

    Terminal
    aider --message "Say hello in one sentence"

Troubleshooting

Aider asks for another service's key (such as ANTHROPIC_API_KEY) or answers 404
The openai/ before the id is missing, so Aider sent the model to its maker's own service. Right: openai/anthropic/claude-sonnet-5.5; openai/ is for Aider and anthropic/ is part of our id.
The warning “Unknown context window size and costs”
Harmless. To stop it, create the “model metadata” file from step 1.
Error 401 or invalid_api_key
The key wasn't copied whole, was revoked, or went in the wrong field. It starts with flux_live_ and has no spaces. If the tool reads it from an environment variable, open a new terminal or window after setting it.
Error 402, insufficient_credit (in Codex: insufficient_quota) although you have credit
Before each request, the most it could cost is set aside from your credit. When the answer ends, only the real cost is taken and the rest is released. A tool that asks for a very long output on every request sets aside a large amount. Lower the tool's output limit (for example to 32000 tokens) or add credit.
A 404 that doesn't mention the model
The base address is wrong. Most tools want https://ai.fluxcdn.cloud/api/v1 and add the rest themselves; don't write /chat/completions twice and don't leave out /v1. See the which address table.
Error 429: rate_limit_exceeded or budget_exceeded
Either requests per minute went over the limit (wait a little; most tools retry by themselves), or this key's spending today or this month reached its limit. See it on API keys under “Limits”.
Error 502, 503, 504 or 529
The model's service was briefly unavailable. Send again; most tools do it themselves. A request that fails before answering costs nothing. If it lasts, switch to another model for a while.

Limits

  • The cost Aider shows doesn't come from FluxCDN; see the real cost under Activity.

What doesn't work this way →