BroadRouter
Começar

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

Atualizado em

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 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.
  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:
{
  "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
            }
          }
        ]
      }
    }
  }
}
  1. 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.
export BROADNET_API_KEY='your-broadnet-key'
  1. 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.
  • 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.
  • 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.

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.

Ler em MarkdownPerguntar ao ChatGPTPerguntar ao ClaudePerguntar ao Perplexity