---
title: "Kilo Code: provedor personalizado compatível com a OpenAI"
description: "Conecte o Kilo Code à BroadNet Inference como provedor OpenAI Compatible personalizado, pela janela do VS Code ou pelo kilo.json, com IDs, limites e tools."
url: https://broadrouter.com/pt/guides/kilo-code-openai-compatible/
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/kilo-code-openai-compatible/) (atualizado em 2026-11-16).

# Usar o Kilo Code com a BroadNet Inference (provedor OpenAI Compatible)

Atualizado em 2026-11-16

No Kilo Code, abra Settings, vá em Providers e clique em Custom provider. Escolha Provider API OpenAI Compatible, defina Base URL como https://inference.broadnet.ai/v1, cole a sua chave da BroadNet e adicione à mão um ID de modelo como broadnet/glm-5.3. No kilo.json, use npm @ai-sdk/openai-compatible com options.baseURL e defina limit.context e limit.output.

O Kilo Code é um agente de programação open source para o VS Code e o terminal. Qualquer provedor com uma API OpenAI Chat Completions pode ser adicionado como **custom provider**. A BroadNet Inference oferece esse formato em `https://inference.broadnet.ai/v1`. O BroadRouter é o site da própria BroadNet; este guia segue [a documentação de provedores do Kilo](https://kilo.ai/docs/ai-providers/openai-compatible) como estava em 15 de novembro de 2026.

## Configuração no VS Code

1.  **Consiga uma chave.** Crie uma chave de pagamento por uso no console da BroadNet, ou use a chave de um [plano ilimitado](https://broadrouter.com/pt/guides/unlimited-llm-api-sessions/).
    
2.  Abra **Settings** (ícone de engrenagem) e vá na aba **Providers**.
    
3.  Role até o fim e clique em **Custom provider**.
    
4.  Preencha a janela:
    
    | Campo | Valor |
    | --- | --- |
    | Provider ID | `broadnet` |
    | Display name | BroadNet Inference |
    | Provider API | **OpenAI Compatible** |
    | Base URL | `https://inference.broadnet.ai/v1` |
    | API key | a sua chave da BroadNet |
    | Models | adicione `broadnet/glm-5.3` à mão (veja abaixo) |
    
5.  Clique em **Submit**. O modelo aparece no seletor de modelos.
    
6.  **Teste.** Comece uma tarefa como “explain this file”. Se ele responder, a conexão funciona.
    

O Kilo tenta preencher a lista de modelos pelo `/v1/models` do endpoint. A documentação da BroadNet descreve esse endpoint como metadados do catálogo para monitores, e quando conferimos, em 15 de novembro de 2026, ele listava só os dois modelos de transcrição. Digite você mesmo os IDs dos modelos de chat e não escolha os modelos de transcrição.

## Configuração no kilo.json (CLI, ou para limites e flags de ferramentas)

A janela do Kilo não define limites de tokens nem tool calling. Para isso, a documentação aponta para o arquivo de configuração: `~/.config/kilo/kilo.json`, ou `./kilo.json` dentro de um projeto.

```jsonc
{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "broadnet/glm-5.3",
  "provider": {
    "broadnet": {
      "npm": "@ai-sdk/openai-compatible",
      "env": ["BROADNET_API_KEY"],
      "options": {
        "baseURL": "https://inference.broadnet.ai/v1"
      },
      "models": {
        "glm-5.3": {
          "id": "broadnet/glm-5.3",
          "name": "GLM 5.3",
          "tool_call": true,
          "reasoning": true,
          "limit": { "context": 1048576, "output": 16000 }
        },
        "qwen3.8-27b": {
          "id": "broadnet/qwen3.8-27b",
          "name": "Qwen3.8 27B",
          "tool_call": true,
          "reasoning": true,
          "modalities": { "input": ["text", "image"], "output": ["text"] },
          "limit": { "context": 262144, "output": 16000 }
        },
        "deepseek-v4.1-flash": {
          "id": "broadnet/deepseek-v4.1-flash",
          "name": "DeepSeek V4.1 Flash",
          "reasoning": true,
          "limit": { "context": 1048576, "output": 16000 }
        }
      }
    }
  }
}
```

```bash
export BROADNET_API_KEY='your-broadnet-key'
```

-   O valor de `model` no nível superior, `broadnet/glm-5.3`, é o nome do provedor mais a chave do mapa (`glm-5.3`), não o ID da BroadNet. O campo `id` é o ID do modelo que o Kilo envia para a BroadNet. A documentação do Kilo diz que `id` assume o valor da chave do mapa por padrão, então defina-o sempre que a chave não for o ID completo da BroadNet, como acontece com as chaves curtas daqui.
-   Sempre defina `limit.context` e `limit.output`. Para um modelo personalizado sem correspondência no catálogo, a documentação do Kilo diz que os dois viram 0, o que desativa o gerenciamento automático de contexto. O valor de saída de 16.000 é sugestão nossa; ele deixa espaço para o raciocínio.
-   `tool_call` ficou de fora do DeepSeek V4.1 Flash de propósito: a documentação da BroadNet não lista tool calling para ele. Adicione depois de testar.

## Qual modelo escolher

| Tarefa | Modelo | Observações |
| --- | --- | --- |
| Programação com agente e ferramentas | [GLM 5.3](https://broadrouter.com/pt/models/glm-5.3/) | Ferramentas e saída estruturada listadas; contexto de 1M |
| Screenshots, árabe | [Qwen3.8 27B](https://broadrouter.com/pt/models/qwen3.8-27b/) | Ferramentas e imagens; contexto de 262K |
| Sessões longas, preço fixo | [DeepSeek V4.1 Flash](https://broadrouter.com/pt/models/deepseek-v4.1-flash/) | Planos ilimitados; ferramentas não listadas pela BroadNet |

Experimente o plano ilimitado com uma hora de Meteor ($1) antes de um mês de Full Moon ($60).

## Solução de problemas

-   **“Invalid API Key” ou 401.** Cole a chave de novo. Confira se ainda há cota na chave e se `BROADNET_API_KEY` está definida no processo que roda o Kilo.
-   **“Model Not Found”.** Confira se o ID é exatamente o da BroadNet, com o prefixo `broadnet/`. Os modelos pagos exigem uma recarga; o crédito de $5 cobre só `broadnet/gemma-4-26b-a4b` e os dois modelos Transcribe.
-   **Resposta vazia ou “response may be incomplete”.** O Kilo avisa quando um modelo de raciocínio gasta toda a saída raciocinando. Aumente `limit.output`. [Por que as respostas vêm vazias](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/).
-   **429.** Uma chave de pagamento por uso permite 30 requisições por minuto e 4 em andamento. Veja [erros e novas tentativas](https://broadrouter.com/pt/guides/errors-and-retries/).
-   **Subagentes em paralelo numa chave de plano esperam ou falham.** Uma sessão do plano roda uma requisição por vez, então dê a cada subagente em paralelo a sua própria sessão.
-   **Erros de conexão.** O Base URL precisa terminar em `/v1`. Se a sua chave tiver uma [lista de IPs permitidos](https://broadrouter.com/pt/guides/api-keys-ip-allow-lists/), adicione o endereço da sua máquina.

## Termos neste guia

[Tool calling (chamada de ferramentas)](https://broadrouter.com/pt/glossary/tool-calling/)

Tool calling, também chamado de function calling ou chamada de ferramentas, é um recurso de APIs de LLM em que o modelo devolve um pedido estruturado para executar uma função definida pelo desenvolvedor, com argumentos JSON. A aplicação executa a função e devolve o resultado; o modelo nunca executa código sozinho.

[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.

[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.

[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.

[Chave de API (API key)](https://broadrouter.com/pt/glossary/api-key/)

Uma chave de API é uma string secreta que identifica e autoriza um cliente que chama uma API. As APIs de LLM normalmente a esperam em um cabeçalho Authorization: Bearer, e qualquer pessoa que tenha a chave pode fazer requisições cobradas da conta dona dela.

[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.

[Lista de IPs permitidos (IP allow list)](https://broadrouter.com/pt/glossary/ip-allow-list/)

Uma lista de IPs permitidos é um controle de segurança que aceita requisições apenas de endereços IP ou faixas CIDR listados e recusa todos os outros. Em uma API, ela limita o estrago de uma chave vazada, porque a chave não funciona a partir de redes que não estão na lista.

[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.

## Perguntas frequentes

### Por que o Kilo Code não lista os modelos de chat da BroadNet depois que coloco o Base URL?

O Kilo busca os modelos na lista /v1/models do endpoint. Quando conferimos, em 15 de novembro de 2026, o /v1/models público da BroadNet listava só os dois modelos de transcrição, então adicione os IDs dos modelos de chat à mão.

### Qual valor usar em limit.context para os modelos da BroadNet?

1048576 para GLM 5.3 e DeepSeek V4.1 Flash, 262144 para Qwen3.8 27B e 32768 para BroadNet Gemma 4 VL 26B. A documentação do Kilo diz que, em modelos personalizados, um limite ausente vira 0, o que desliga o gerenciamento automático de contexto.

### Posso usar o Kilo Code no plano ilimitado da BroadNet?

Sim. Os planos cobrem o DeepSeek V4.1 Flash, ID broadnet/deepseek-v4.1-flash. Use a chave do plano como chave de API. A documentação da BroadNet não lista tool calling para esse modelo, então teste uma tarefa de agente primeiro.

### Como Provider API, escolho OpenAI Compatible ou OpenAI Responses?

OpenAI Compatible. A BroadNet oferece chat completions em /v1/chat/completions e não lista a Responses API.

## Guias relacionados

-   [Use o Cline com a BroadNet Inference (provedor OpenAI Compatible)](https://broadrouter.com/pt/guides/cline-openai-compatible/)
-   [Adicionar a BroadNet Inference ao opencode como provedor personalizado](https://broadrouter.com/pt/guides/opencode-custom-provider/)
-   [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/)
-   [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-kilo-code-openai-compatible&utm_content=page-cta) ·

**Fontes**

-   [Documentação do Kilo Code, Using OpenAI-Compatible Providers (conferido em 2026-11-15)](https://kilo.ai/docs/ai-providers/openai-compatible)
-   [Documentação do Kilo Code, Custom Models (campos id, tool\_call, limit) (conferido em 2026-11-15)](https://kilo.ai/docs/code-with-ai/agents/custom-models)
-   [Referência da API da BroadNet Inference (conferido em 2026-11-15) (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-guides-kilo-code-openai-compatible&utm_content=sources)
