BroadRouter
Começar

Adicionar a BroadNet Inference ao opencode como provedor personalizado

Atualizado em

No opencode.jsonc, adicione uma entrada broadnet em providers com package @opencode/ai/providers/openai-compatible, settings.baseURL como https://inference.broadnet.ai/v1 e env como BROADNET_API_KEY. Mapeie chaves curtas para os IDs da BroadNet com modelID, como broadnet/glm-5.3, e escolha o modelo com /models. Configurações V1 antigas com npm @ai-sdk/openai-compatible e options.baseURL continuam funcionando.

O opencode é um agente de código open source para o terminal. Provedores que não estão no catálogo nativo dele são adicionados como provedores personalizados no opencode.jsonc. A BroadNet Inference fala o formato chat completions da OpenAI, então usa o pacote de runtime compatível com a OpenAI do opencode. Este guia segue a documentação atual (V2) do opencode.

Configuração

  1. Exporte a sua chave no shell que inicia o opencode:
export BROADNET_API_KEY='your-broadnet-key'
  1. Crie a configuração. Coloque no seu projeto como opencode.jsonc, ou em ~/.config/opencode/opencode.jsonc para usar em todo lugar.
{
  "$schema": "https://opencode.ai/config.json",
  "model": "broadnet/glm-5.3",
  "providers": {
    "broadnet": {
      "name": "BroadNet Inference",
      "env": ["BROADNET_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": {
        "baseURL": "https://inference.broadnet.ai/v1"
      },
      "models": {
        "glm-5.3": {
          "modelID": "broadnet/glm-5.3",
          "name": "GLM 5.3",
          "capabilities": { "tools": true, "input": ["text"], "output": ["text"] },
          "limit": { "context": 1048576, "output": 16000 }
        },
        "deepseek-v4.1-flash": {
          "modelID": "broadnet/deepseek-v4.1-flash",
          "name": "DeepSeek V4.1 Flash",
          // BroadNet's docs don't list tool calling for this model: test it first
          "capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
          "limit": { "context": 1048576, "output": 16000 }
        },
        "qwen3.8-27b": {
          "modelID": "broadnet/qwen3.8-27b",
          "name": "Qwen3.8 27B",
          "capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
          "limit": { "context": 262144, "output": 16000 }
        }
      }
    }
  }
}
  1. Inicie o opencode e escolha o modelo com /models. A referência é broadnet/<map key>, por exemplo broadnet/glm-5.3. O opencode envia à BroadNet o valor de modelID.

Os arquivos de configuração são mesclados. O opencode aplica primeiro o arquivo global, depois os arquivos de projeto encontrados subindo a partir do diretório atual (os mais distantes primeiro) e, por fim, qualquer configuração em .opencode/; assim, um arquivo de projeto pode sobrescrever o provedor global. A configuração de sistema gerenciada, se a sua empresa usar, tem prioridade sobre os dois. Mantenha a chave no ambiente, não no arquivo, para poder colocar a configuração no controle de versão.

Por que os aliases

Os IDs da BroadNet já têm uma barra (broadnet/glm-5.3). A chave do mapa models é o que o opencode mostra e seleciona, e modelID é o que ele envia. Chaves curtas deixam as referências legíveis.

Defina capabilities e limit você mesmo. Para um modelo fora do catálogo, o opencode supõe suporte a ferramentas em JSON, entrada de texto e imagem, contexto de 200.000 tokens e 32.000 tokens de saída. A documentação dele chama isso de suposições de fallback, não de valores detectados. O valor output de 16000 acima é sugestão nossa, não um limite da BroadNet; ele deixa espaço para o raciocínio.

Configurações V1 antigas

O opencode V2 ainda lê o formato V1, então um bloco existente como este continua funcionando:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "broadnet": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BroadNet Inference",
      "options": {
        "baseURL": "https://inference.broadnet.ai/v1",
        "apiKey": "{env:BROADNET_API_KEY}"
      },
      "models": {
        "broadnet/glm-5.3": { "name": "GLM 5.3" }
      }
    }
  }
}

Na forma nativa V2, provider vira providers, npm vira package (aisdk:@ai-sdk/openai-compatible se quiser manter o pacote do AI SDK), e options.baseURL e options.apiKey passam para dentro de settings. O guia de migração da V1 do opencode mostra a correspondência de cada campo.

Qual modelo escolher

Tarefa Modelo Observações
Código com agente e ferramentas GLM 5.3 Ferramentas e saída estruturada listadas; contexto de 1M
Screenshots, árabe Qwen3.8 27B Ferramentas e imagens; contexto de 262K
Sessões o dia inteiro, preço fixo DeepSeek V4.1 Flash Planos ilimitados; ferramentas não listadas pela BroadNet

O opencode depende de chamadas de ferramentas. A documentação da BroadNet não lista tool calling para o DeepSeek V4.1 Flash, então a configuração marca isso como uma suposição a testar. Rode uma tarefa real com uma hora de Meteor ($1) antes de comprar um mês de Full Moon ($60).

Solução de problemas

  • 401. A chave em BROADNET_API_KEY está errada, expirou ou ficou sem cota de pagamento por uso. Confirme que a variável está definida no processo que roda o opencode.
  • Modelo não encontrado ou rejeitado. Selecione a chave do mapa (broadnet/glm-5.3) e confira se modelID é exatamente o ID da BroadNet. As referências diferenciam maiúsculas de minúsculas. Os modelos pagos exigem uma recarga; o crédito de $5 cobre só broadnet/gemma-4-26b-a4b e os dois modelos Transcribe.
  • Respostas vazias. Aumente limit.output. Por que as respostas voltam vazias.
  • 429. Chaves de pagamento por uso permitem 30 requisições por minuto e 4 em andamento. As novas tentativas também contam. Veja erros e novas tentativas.
  • Subagentes num plano. Cada sessão do plano atende uma requisição por vez, então subagentes em paralelo entram na fila, a menos que cada um tenha a própria sessão.

Perguntas frequentes

Por que o opencode não encontra meu modelo da BroadNet?

O opencode resolve a referência como provedor/chave do mapa, e os IDs diferenciam maiúsculas de minúsculas. Com a configuração abaixo, selecione broadnet/glm-5.3, em que glm-5.3 é a chave do mapa. O valor de modelID é só o que é enviado à BroadNet.

Minha configuração usa provider e npm com @ai-sdk/openai-compatible. Está errado?

Não. Esse é o formato V1, e o guia de migração do opencode diz que ele continua suportado. A forma nativa V2 renomeia provider para providers, npm para package (aisdk:@ai-sdk/openai-compatible) e options.baseURL para settings.baseURL.

Por que as respostas do opencode vêm vazias?

O modelo gastou o orçamento de saída com raciocínio. Aumente limit.output desse modelo. Na BroadNet, o raciocínio conta em max_tokens.

Ler em MarkdownPerguntar ao ChatGPTPerguntar ao ClaudePerguntar ao Perplexity