---
title: "Zed: provedor compatível com OpenAI (GLM, Qwen) | BroadRouter"
description: "Adicione a BroadNet Inference ao Zed como provedor compatível com a OpenAI no settings.json, com IDs de modelo, limites de tokens, capabilities e variável da chave."
url: https://broadrouter.com/pt/guides/zed-openai-compatible-provider/
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/zed-openai-compatible-provider/) (atualizado em 2026-11-16).

# Use o Zed com a BroadNet Inference como provedor compatível com OpenAI

Atualizado em 2026-11-16

No settings.json do Zed, adicione um provedor em language\_models.openai\_compatible, por exemplo broadnet, com api\_url definido como https://inference.broadnet.ai/v1 e available\_models listando IDs da BroadNet, como broadnet/glm-5.3, com max\_tokens igual ao tamanho do contexto. O Zed lê a chave de BROADNET\_API\_KEY, ou você pode salvá-la em Agent Settings.

O Zed é um editor de código open source com um agente embutido. Ele se conecta a qualquer servidor com API compatível com a OpenAI pelo tipo de provedor `openai_compatible`. A BroadNet Inference serve chat completions padrão em `https://inference.broadnet.ai/v1`, então se encaixa. O BroadRouter é o site da própria BroadNet; os passos abaixo seguem a [documentação de acesso por API do Zed](https://zed.dev/docs/ai/use-api-access#openai-compatible) na versão 1.28.

## Configuração

1.  **Pegue 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.  **Adicione o provedor.** Abra o Agent Settings com o comando `agent: open settings` e clique em **Add Provider** na seção LLM Providers, ou edite o `settings.json` direto:

```json
{
  "language_models": {
    "openai_compatible": {
      "broadnet": {
        "api_url": "https://inference.broadnet.ai/v1",
        "available_models": [
          {
            "name": "broadnet/glm-5.3",
            "display_name": "GLM 5.3 (BroadNet)",
            "max_tokens": 1048576,
            "max_output_tokens": 16000,
            "capabilities": {
              "tools": true,
              "images": false,
              "parallel_tool_calls": false,
              "prompt_cache_key": false,
              "chat_completions": true,
              "interleaved_reasoning": false,
              "max_tokens_parameter": true
            }
          },
          {
            "name": "broadnet/qwen3.8-27b",
            "display_name": "Qwen3.8 27B (BroadNet)",
            "max_tokens": 262144,
            "max_output_tokens": 16000,
            "capabilities": {
              "tools": true,
              "images": true,
              "parallel_tool_calls": false,
              "prompt_cache_key": false,
              "chat_completions": true,
              "interleaved_reasoning": false,
              "max_tokens_parameter": true
            }
          }
        ]
      }
    }
  }
}
```

3.  **Passe a chave para o Zed.** Exporte a chave antes de abrir o Zed ou cole no provedor em Agent Settings. O Zed guarda chaves coladas no chaveiro do sistema, não no `settings.json`.

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

4.  **Teste.** Abra o Agent Panel, escolha **GLM 5.3 (BroadNet)** no seletor de modelos e faça uma pergunta pequena sobre um arquivo aberto. Se vier uma resposta, a conexão funciona.

## O que as configurações significam

-   **`name`** é o ID de modelo que o Zed envia. Use o ID da BroadNet exatamente, com o prefixo `broadnet/`.
-   **`max_tokens`** é a janela de contexto no schema do Zed, não o limite de saída. Use 1.048.576 para o GLM 5.3 e o DeepSeek V4.1 Flash, e 262.144 para o Qwen3.8 27B.
-   **`max_output_tokens`** limita a resposta. O valor de 16.000 acima é sugestão nossa, não um limite da BroadNet. O raciocínio conta nesse limite, então não coloque um valor baixo.
-   **`max_tokens_parameter: true`** faz o Zed enviar o limite de saída como `max_tokens` em vez de `max_completion_tokens`. A referência da API da BroadNet descreve o campo `max_tokens`.
-   **`images`** é false por padrão em modelos compatíveis com a OpenAI. Ative só para modelos que aceitam imagens: Qwen3.8 27B, DeepSeek V4.1 Flash e BroadNet Gemma 4 VL 26B.
-   **`reasoning_effort`** é opcional. A documentação da BroadNet sugere `low` se você quiser um raciocínio mais curto.

## Qual modelo escolher

| Uso | Modelo | Por quê |
| --- | --- | --- |
| Edições do agente com ferramentas | `broadnet/glm-5.3` | A BroadNet lista ferramentas e saída estruturada; contexto de 1M |
| Capturas de tela e texto em árabe | `broadnet/qwen3.8-27b` | Ferramentas mais entrada de imagem; contexto de 262K |
| Conversas longas em um plano de preço fixo | `broadnet/deepseek-v4.1-flash` | O modelo do plano ilimitado; entrada de imagem; a BroadNet não lista ferramentas |

O Zed presume `tools: true` para modelos compatíveis com a OpenAI. A documentação da BroadNet não lista tool calling para o DeepSeek V4.1 Flash, então teste uma tarefa real do agente com ele antes de depender disso. Uma hora de Meteor ($1) é um jeito barato de testar antes de um mês de Full Moon ($60).

## Solução de problemas

-   **401.** A chave está errada, expirada ou sem cota. Se você definiu `BROADNET_API_KEY`, ela tem prioridade sobre o chaveiro; remova a variável e reinicie o Zed para usar a chave salva.
-   **404 em toda requisição.** Confira se o `api_url` termina em `/v1`. Depois confira se o `name` bate exatamente com o ID da BroadNet. Modelos pagos exigem recarga; o crédito de $5 cobre só o `broadnet/gemma-4-26b-a4b` e os dois modelos Transcribe.
-   **Respostas vazias.** O modelo gastou o orçamento de saída com raciocínio. Aumente `max_output_tokens` ou defina `reasoning_effort` como `low`. [Por que as respostas voltam 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. Uma sessão de plano roda uma requisição por vez. Veja [erros e novas tentativas](https://broadrouter.com/pt/guides/errors-and-retries/).
-   **Projetos remotos.** O Zed inicializa os provedores no app local, então via SSH a chave vem do chaveiro ou do ambiente local, não da máquina remota.

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

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

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

[API compatível com a OpenAI](https://broadrouter.com/pt/glossary/openai-compatible-api/)

Uma API compatível com a OpenAI é uma API HTTP que aceita os mesmos formatos de requisição e de resposta da API da OpenAI, como POST /v1/chat/completions, de modo que SDKs e ferramentas da OpenAI podem usá-la trocando só a base URL, a chave de API e o nome do modelo.

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

[Crédito pré-pago (prepaid credit)](https://broadrouter.com/pt/glossary/prepaid-credit/)

Crédito pré-pago é dinheiro adicionado a uma conta de API antes do uso. Cada requisição desconta o próprio custo do saldo e, quando o saldo acaba, as requisições cobradas por uso param até você fazer uma recarga. Ele limita o gasto ao que você já pagou.

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

## Perguntas frequentes

### Qual variável de ambiente o Zed lê para a chave de um provedor personalizado?

O Zed monta o nome a partir do ID do provedor em upper snake case mais \_API\_KEY. Um provedor chamado broadnet lê BROADNET\_API\_KEY. Uma variável não vazia tem prioridade sobre uma chave salva no chaveiro.

### O modelo da BroadNet funciona no Agent Panel do Zed?

Sim. O acesso por API do Zed cobre o Zed Agent, o Inline Assistant, mensagens de commit e resumos de threads. O Zed presume suporte a ferramentas em modelos compatíveis com a OpenAI, então escolha o GLM 5.3 ou o Qwen3.8 27B, que a BroadNet lista com ferramentas.

### Isso muda as edit predictions do Zed?

Não. A documentação do Zed diz que a edit prediction tem uma configuração de provedor própria, em edit\_predictions. O provedor deste guia serve para o agente e os outros recursos de IA do Zed.

### Por que o Zed diz que o modelo só funciona com a Responses API?

Com a BroadNet isso não deveria acontecer. Deixe capabilities.chat\_completions no padrão true. A BroadNet serve /v1/chat/completions e não lista a Responses API.

## Guias relacionados

-   [Usar o Kilo Code com a BroadNet Inference (provedor OpenAI Compatible)](https://broadrouter.com/pt/guides/kilo-code-openai-compatible/)
-   [Use o Cline com a BroadNet Inference (provedor OpenAI Compatible)](https://broadrouter.com/pt/guides/cline-openai-compatible/)
-   [Por que um modelo de raciocínio devolve uma resposta vazia](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/)
-   [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-zed-openai-compatible-provider&utm_content=page-cta) ·

**Fontes**

-   [Documentação do Zed, Use API Access, endpoints compatíveis com a OpenAI (conferido em 2026-11-15)](https://zed.dev/docs/ai/use-api-access#openai-compatible)
-   [Releases do Zed no GitHub, v1.28.1 a mais recente (conferido em 2026-11-15)](https://github.com/zed-industries/zed/releases)
-   [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-zed-openai-compatible-provider&utm_content=sources)
