---
title: "Aider com API compatível com a OpenAI (DeepSeek ilimitado)"
description: "Conecte o agente de programação Aider à BroadNet Inference pela configuração compatível com a OpenAI e use um plano ilimitado de preço fixo do DeepSeek V4.1 Flash."
url: https://broadrouter.com/pt/guides/aider-unlimited-deepseek/
lang: pt-BR
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traduzido do inglês com ajuda de IA. [Leia o original em inglês](https://broadrouter.com/guides/aider-unlimited-deepseek/) (atualizado em 2026-11-16).

# Rode o Aider no DeepSeek V4.1 Flash ilimitado

Atualizado em 2026-11-16

O Aider se conecta a qualquer API compatível com a OpenAI. Defina OPENAI\_API\_BASE como https://inference.broadnet.ai/v1 e OPENAI\_API\_KEY com a sua chave da BroadNet, depois rode aider --model openai/broadnet/deepseek-v4.1-flash. O prefixo openai/ escolhe a rota compatível com a OpenAI do Aider. Com a chave de um plano ilimitado, os tokens do DeepSeek V4.1 Flash não são medidos, então sessões longas no repositório ficam com preço fixo.

Agentes de programação reenviam grandes partes do seu repositório a cada turno, então a cobrança por token cresce rápido. Uma [sessão de plano ilimitado](https://broadrouter.com/pt/guides/unlimited-llm-api-sessions/) tira o medidor da jogada. Os passos seguem a [configuração compatível com a OpenAI do Aider](https://aider.chat/docs/llms/openai-compat.html).

## 1\. Instale o Aider

```bash
python -m pip install aider-install
aider-install
```

## 2\. Aponte para a BroadNet Inference

```bash
export OPENAI_API_BASE=https://inference.broadnet.ai/v1
export OPENAI_API_KEY='your-broadnet-plan-key'
```

No Windows, use `setx OPENAI_API_BASE https://inference.broadnet.ai/v1` e `setx OPENAI_API_KEY your-key` e depois abra um terminal novo. A documentação do Aider manda reiniciar o shell depois do `setx`.

Mantenha o `/v1` no fim do base URL. O próprio Aider adiciona o caminho de chat completions.

## 3\. Inicie no seu código

```bash
cd /path/to/your/project
aider --model openai/broadnet/deepseek-v4.1-flash
```

O prefixo `openai/` diz ao Aider para usar o endpoint compatível com a OpenAI; o resto é o ID do modelo na BroadNet. O Aider vai avisar: “Unknown context window size and costs, using sane defaults.” (tradução: “Tamanho da janela de contexto e custos desconhecidos, usando padrões razoáveis.”). Isso é esperado para modelos fora da lista embutida dele. A [página de avisos de modelo](https://aider.chat/docs/llms/warnings.html) diz que o aviso geralmente pode ser ignorado.

## 4\. Opcional: informe o modelo ao Aider

Para tirar o aviso e dar espaço para o modelo raciocinar, adicione dois arquivos ao seu diretório home ou à raiz do repositório. O Aider lê os dois em qualquer um desses lugares, como descrito na [documentação de configurações avançadas de modelo](https://aider.chat/docs/config/adv-model-settings.html).

`.aider.model.metadata.json`:

```json
{
  "openai/broadnet/deepseek-v4.1-flash": {
    "max_input_tokens": 1048576,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}
```

`.aider.model.settings.yml`:

```yaml
- name: openai/broadnet/deepseek-v4.1-flash
  edit_format: diff
  extra_params:
    max_tokens: 16000
```

O formato de edição padrão do Aider para modelos desconhecidos é `whole`, que reenvia arquivos inteiros. `diff` envia só os blocos alterados. Se as edições não forem aplicadas, remova a linha `edit_format` para voltar ao `whole`.

## Dicas

-   **Uma janela do Aider, uma sessão.** Se você rodar duas instâncias do Aider ao mesmo tempo, compre duas sessões, ou elas ficam uma na fila da outra.
-   **Raciocínio gasta tokens.** O DeepSeek V4.1 Flash raciocina antes de responder, e a BroadNet conta isso em `max_tokens`. [Por que as respostas vêm vazias](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/).
-   **Teste uma hora primeiro.** Um plano Meteor custa $1 por uma hora, o suficiente para avaliá-lo em uma tarefa real.

## Solução de problemas

-   **401 Unauthorized.** `OPENAI_API_KEY` está faltando, errada ou expirada. Confira se o shell que roda o Aider tem a variável; no Windows, abra um terminal novo depois do `setx`.
-   **As requisições vão para a OpenAI em vez da BroadNet.** `OPENAI_API_BASE` não está definida neste shell, ou o nome do modelo está sem o prefixo `openai/`. Rode `echo $OPENAI_API_BASE` para conferir.
-   **Modelo não encontrado.** A parte depois de `openai/` precisa ser exatamente `broadnet/deepseek-v4.1-flash`. Uma chave de plano cobre só o DeepSeek V4.1 Flash; os outros modelos da BroadNet precisam de uma chave de pagamento por uso.
-   **Respostas vazias ou cortadas.** Aumente `max_tokens` em `.aider.model.settings.yml`, como mostrado acima.
-   **As edições não são aplicadas.** Volte `edit_format` para `whole` ou teste `--edit-format whole` na linha de comando.
-   **Respostas lentas ou 429.** Uma sessão do plano roda uma requisição por vez; uma segunda janela do Aider fica na fila. Uma chave de pagamento por uso permite 30 requisições por minuto e 4 ao mesmo tempo. Veja [erros e novas tentativas](https://broadrouter.com/pt/guides/errors-and-retries/).

Prefere um agente dentro do VS Code? Veja [o guia de configuração do Cline](https://broadrouter.com/pt/guides/cline-openai-compatible/) ou compare os dois em [Cline vs Roo Code vs Aider](https://broadrouter.com/pt/blog/cline-vs-roo-code-vs-aider/).

[Escolha um plano na BroadNet Inference](https://inference.broadnet.ai/plans?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-guides-aider-unlimited-deepseek&utm_content=body)

## Termos neste guia

[Token](https://broadrouter.com/pt/glossary/token/)

Um token é a unidade de texto que um modelo de linguagem lê e escreve: uma palavra, parte de uma palavra, um sinal de pontuação ou uma sequência de bytes gerada pelo tokenizador do modelo. As APIs de LLM contam, limitam e normalmente cobram o uso em tokens.

[Pagamento por uso (pay-as-you-go)](https://broadrouter.com/pt/glossary/pay-as-you-go/)

Pagamento por uso é um modelo de preço em que você paga só pelo que usa, medido por unidade, como tokens, requisições ou minutos de áudio, sem assinatura nem compromisso mínimo. A maioria das APIs de LLM cobra assim, a partir de um saldo pré-pago ou de uma fatura periódica.

[Janela de contexto (context window)](https://broadrouter.com/pt/glossary/context-window/)

A janela de contexto é o número máximo de tokens com que um modelo de linguagem consegue trabalhar em uma única requisição. Ela abrange o prompt, o histórico da conversa, as definições de ferramentas, as imagens e a saída gerada, incluindo os tokens de raciocínio. O que não couber precisa ser cortado, resumido ou dividido em várias requisições.

[Base URL (URL base)](https://broadrouter.com/pt/glossary/base-url/)

A base URL é o endereço raiz fixo de uma API, como https://api.example.com/v1, que um cliente coloca antes de cada caminho de endpoint, como /chat/completions. Nos SDKs compatíveis com a OpenAI, trocar a base URL, junto com a chave de API e o ID do modelo, aponta o mesmo código para outro provedor.

[Concorrência (concurrency)](https://broadrouter.com/pt/glossary/concurrency/)

Concorrência é o número de requisições que um cliente tem em andamento ao mesmo tempo. APIs de LLM muitas vezes a limitam por chave ou por plano, separadamente das requisições por minuto, porque cada requisição aberta ocupa capacidade de GPU até a resposta terminar.

[Rate limit (limite de taxa)](https://broadrouter.com/pt/glossary/rate-limit/)

Um rate limit é um teto que uma API impõe a quanto um cliente pode usá-la em um intervalo de tempo, como requisições por minuto ou tokens por minuto. As requisições acima do limite são recusadas, normalmente com HTTP 429 Too Many Requests, até que o uso volte a ficar abaixo dele.

[Chat Completions API](https://broadrouter.com/pt/glossary/chat-completions-api/)

A Chat Completions API é o endpoint HTTP da OpenAI, POST /v1/chat/completions, que recebe o nome de um modelo e uma lista de mensagens marcadas com papéis e devolve a próxima mensagem do modelo. O formato da requisição e da resposta virou o padrão comum que provedores e SDKs compatíveis com a OpenAI reutilizam.

## Perguntas frequentes

### Como usar o Aider com uma API compatível com a OpenAI?

Defina OPENAI\_API\_BASE com o base URL do provedor e OPENAI\_API\_KEY com a chave dele, depois inicie o aider com --model openai/ seguido do ID do modelo no provedor. Na BroadNet, isso fica openai/broadnet/deepseek-v4.1-flash, com base URL https://inference.broadnet.ai/v1.

### Por que o Aider mostra "Unknown context window size and costs"?

O Aider não tem metadados embutidos para os IDs de modelo da BroadNet, então assume contexto ilimitado e custo zero. A documentação do Aider diz que o aviso geralmente pode ser ignorado. Para removê-lo, adicione o modelo em .aider.model.metadata.json.

### Preciso do prefixo openai/ se o ID do modelo já começa com broadnet/?

Sim. O Aider lê a primeira parte como a rota do provedor. openai/ envia a requisição para OPENAI\_API\_BASE, e broadnet/deepseek-v4.1-flash é o ID de modelo que a BroadNet recebe.

### Por que o Aider recebe respostas vazias ou cortadas do DeepSeek V4.1 Flash?

O modelo raciocina antes de responder, e a BroadNet conta o raciocínio em max\_tokens. Defina um max\_tokens maior via extra\_params em .aider.model.settings.yml.

## Guias relacionados

-   [Como funcionam os planos de API de LLM ilimitada para agentes](https://broadrouter.com/pt/guides/unlimited-llm-api-sessions/)
-   [Por que um modelo de raciocínio devolve uma resposta vazia](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/)
-   [Use o Cline com a BroadNet Inference (provedor OpenAI Compatible)](https://broadrouter.com/pt/guides/cline-openai-compatible/)
-   [Códigos de erro da BroadNet Inference e quando tentar de novo](https://broadrouter.com/pt/guides/errors-and-retries/)
-   [Todas as ferramentas que funcionam com a BroadNet Inference (em inglês)](https://broadrouter.com/integrations/): SDKs, agentes de programação, interfaces de chat e ferramentas de automação, com as configurações exatas de cada uma

Teste com a sua carga de trabalho real. Contas novas começam com US$ 5 de crédito para Gemma e transcrição. DeepSeek, GLM e Qwen3.8 exigem uma recarga.

[Começar](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-guides-aider-unlimited-deepseek&utm_content=page-cta) ·

**Fontes**

-   [Documentação do Aider, APIs compatíveis com a OpenAI (conferido em 2026-11-14)](https://aider.chat/docs/llms/openai-compat.html)
-   [Documentação do Aider, avisos de modelo (conferido em 2026-11-14)](https://aider.chat/docs/llms/warnings.html)
-   [Documentação do Aider, configurações avançadas de modelo (conferido em 2026-11-14)](https://aider.chat/docs/config/adv-model-settings.html)
-   [Referência da API da BroadNet Inference (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-guides-aider-unlimited-deepseek&utm_content=sources)
-   [Planos ilimitados da BroadNet Inference (em inglês)](https://inference.broadnet.ai/plans?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-guides-aider-unlimited-deepseek&utm_content=sources)
