BroadRouter

Como usar a BroadNet Inference no n8n (credencial OpenAI, Base URL)

Atualizado em

No n8n, crie uma credencial OpenAI com a sua chave da BroadNet em API Key e o Base URL definido como https://inference.broadnet.ai/v1. No nó OpenAI Chat Model, mude Model de From List para ID, digite um ID da BroadNet como broadnet/glm-5.3 e desligue Use Responses API para que o n8n chame chat completions.

O n8n é uma ferramenta de automação de workflows. A credencial OpenAI dele tem um campo Base URL, então o nó OpenAI Chat Model (e os outros nós OpenAI que usam a credencial) consegue chamar qualquer API compatível com a OpenAI. A BroadNet Inference é uma delas. A página da documentação do n8n sobre a credencial não mostra o campo Base URL, por isso os nomes de campos abaixo também foram conferidos no código-fonte do n8n, com links nas fontes.

Configuração

  1. Crie a credencial. No n8n, vá em Credentials, crie uma nova credencial OpenAI e preencha:

    Campo Valor
    API Key a sua chave da BroadNet
    Organization ID (optional) deixe em branco
    Base URL https://inference.broadnet.ai/v1

    Salve. O n8n testa a credencial chamando /models no Base URL.

  2. Adicione o nó do modelo. Adicione um nó AI Agent ou Basic LLM Chain, conecte um subnó OpenAI Chat Model e selecione a credencial.

  3. Defina o modelo por ID. Em Model, mude o modo de From List para ID e digite broadnet/glm-5.3.

  4. Desligue Use Responses API. No código-fonte do n8n, essa opção existe a partir da versão 1.3 do nó e vem ligada por padrão. A BroadNet oferece chat completions, então desligue.

  5. Ajuste as opções. Em Options, deixe Maximum Number of Tokens no padrão (-1) ou defina alguns milhares. Max Retries vem com 2 por padrão; aumente se quiser que o n8n tente de novo as chamadas que falharem com mais frequência.

  6. Execute o workflow uma vez com um prompt de teste.

Quando você usa um Base URL que não é da OpenAI, o n8n mostra um aviso: not all models might be chat-compatible or support tools calling or JSON response format (tradução: nem todos os modelos podem ser compatíveis com chat ou suportar tool calling ou o formato de resposta JSON). Na BroadNet, o chat funciona em todos os modelos de chat, mas a documentação da BroadNet lista ferramentas e saída estruturada só para GLM 5.3 e Qwen3.8 27B.

Qual modelo escolher

Workflow Modelo Por quê
AI Agent com ferramentas broadnet/glm-5.3 Ferramentas e saída estruturada listadas pela BroadNet
Imagens, mensagens em árabe broadnet/qwen3.8-27b Ferramentas, entrada de imagens, testado em árabe
Classificação em grande volume broadnet/gemma-4-26b-a4b Preço por token baixo; sem raciocínio listado
Documentos longos broadnet/deepseek-v4.1-flash Contexto de 1M; ferramentas não listadas

Compare os preços na página de preços. Para áudio, o nó HTTP Request do n8n pode enviar arquivos para /v1/audio/transcriptions; o guia de fala para texto em árabe mostra os campos do formulário a enviar.

Solução de problemas

  • O teste da credencial falha. Confira se o Base URL termina em /v1, sem caminho depois. Se as chamadas de chat também retornarem 401, a chave está errada, expirou ou ficou sem cota de pagamento por uso.
  • Erros de modelo. Use o modo ID e digite o ID exato da BroadNet, com o prefixo broadnet/. GLM 5.3, Qwen3.8 27B e DeepSeek V4.1 Flash exigem uma recarga; o crédito inicial de $5 cobre o BroadNet Gemma 4 VL 26B.
  • “Bad request - please check your parameters” (tradução: requisição inválida, confira os parâmetros). A documentação do n8n sugere repetir a chamada em um nó HTTP Request para ver o erro completo. Uma causa comum aqui é a opção da Responses API.
  • Saída vazia. O raciocínio conta para o Maximum Number of Tokens. Aumente o valor. Por que as respostas vêm vazias.
  • 429 em loops. Uma chave de pagamento por uso permite 30 requisições por minuto e 4 ao mesmo tempo. A documentação do n8n sugere Loop Over Items com um nó Wait para espaçar os lotes. Veja erros e novas tentativas.
  • Execuções em paralelo com uma chave de plano. Uma sessão do plano ilimitado roda uma requisição por vez. Execuções paralelas do workflow entram em fila, a menos que cada uma tenha a própria sessão.

Prefere código? As mesmas configurações funcionam no LangChain, base dos nós de IA do n8n.

Perguntas frequentes

Por que o AI Agent do n8n falha com a BroadNet?

Confira se Use Responses API está desligado no nó OpenAI Chat Model. Na versão 1.3 do nó ele vem ligado por padrão, e a BroadNet oferece /v1/chat/completions, não a Responses API. Coloque também Model no modo ID com o ID exato da BroadNet.

Por que a lista de modelos aparece vazia ou errada?

O modo From List lê o endpoint /models do provedor. A documentação da BroadNet descreve esse endpoint como metadados públicos do catálogo para monitores. Mude Model para o modo ID e digite o ID do modelo da BroadNet.

Por que o agente do n8n devolve uma saída vazia?

O raciocínio esgotou o Maximum Number of Tokens. Aumente o valor ou deixe no padrão, -1.

Onde fica o campo Base URL na credencial OpenAI do n8n?

Fica na própria credencial OpenAI, abaixo de API Key e Organization ID. O padrão é https://api.openai.com/v1. Troque por https://inference.broadnet.ai/v1, mantendo o /v1 e sem acrescentar nenhum outro caminho.

Ler em MarkdownPerguntar ao ChatGPTPerguntar ao ClaudePerguntar ao Perplexity