Aider com uma API compatível com OpenAI mais barata (MartLLM)
Defina OPENAI_API_BASE=https://api.martllm.com/v1 e OPENAI_API_KEY para sua chave MartLLM, depois execute aider --model openai/<MartLLM model id>. Adicione um .aider.model.settings.yml para que o Aider edite com diffs e use seu repo map.
Mais rápido: um comando
npx uberllm init --tool aider
Ele cria uma chave no seu navegador, escreve .aider.conf.yml na sua pasta pessoal (ou em um repositório com --project) e adiciona as configurações do modelo que ativam as edições de diff e o mapa do repositório. O arquivo é feito backup primeiro, e npx uberllm init --undo o restaura. O que ele muda. Para fazer isso manualmente, siga os passos abaixo.
Passos
- Crie uma chave na sua página de chaves e adicione crédito.
- Defina duas variáveis:
export OPENAI_API_BASE=https://api.martllm.com/v1
export OPENAI_API_KEY=ull_your_key
Windows: setx OPENAI_API_BASE https://api.martllm.com/v1 e setx OPENAI_API_KEY ull_your_key, depois abra um novo terminal.
- Execute o Aider com
openai/na frente do ID do MartLLM:
aider --model openai/moonshotai/kimi-k3 --weak-model openai/deepseek/deepseek-v4.1-flash
openai/ informa ao Aider para usar a rota compatível com OpenAI. Apenas essa primeira parte é removida, então o ID que chega ao MartLLM é moonshotai/kimi-k3.
Faça as edições funcionarem corretamente (importante)
Aider escolhe as configurações de edição pelo nome do modelo. Para um modelo que não conhece, ele volta a reescrever arquivos inteiros e desativa o mapa do repositório: mais lento, mais tokens, resultados piores. Informe as configurações corretas em .aider.model.settings.yml (na sua pasta inicial ou na raiz do repositório):
- name: openai/moonshotai/kimi-k3
edit_format: diff
use_repo_map: true
name deve ser exatamente o que você passa para --model.
Silenciar o aviso de "janela de contexto desconhecida"
Aider avisa que não sabe o tamanho e o preço do modelo. Dê a ele os números em .aider.model.metadata.json, usando a página do modelo em martllm.com/models:
{
"openai/moonshotai/kimi-k3": {
"max_input_tokens": 200000,
"max_output_tokens": 32000,
"input_cost_per_token": 0.000001,
"output_cost_per_token": 0.000004,
"litellm_provider": "openai",
"mode": "chat"
}
}
Os números são um exemplo: copie o comprimento de contexto real e divida os preços por-1M na tabela abaixo por 1,000,000. Aider então mostra um custo próximo ao que você paga. Ou apenas desligue o aviso com show-model-warnings: false.
Mantenha-o em um arquivo de configuração
.aider.conf.yml na sua pasta home ou repositório:
openai-api-base: https://api.martllm.com/v1
openai-api-key: ull_your_key
model: openai/moonshotai/kimi-k3
weak-model: openai/deepseek/deepseek-v4.1-flash
Não faça commit de um arquivo que contenha sua chave.
Solução de Problemas
- "Tamanho da janela de contexto e custos desconhecidos": inofensivo; adicione o arquivo de metadados acima.
- Aider reescreve arquivos inteiros: o arquivo de configurações está faltando ou seu
namenão corresponde a--model. - Modelo 404 não encontrado: o prefixo
openai/está faltando, ou o ID depois dele está errado. - Variáveis ignoradas no Windows:
setxse aplica apenas a novos terminais. - 402 créditos insuficientes: adicione crédito na página de créditos.