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
-
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/v1Salve. O n8n testa a credencial chamando
/modelsno Base URL. -
Adicione o nó do modelo. Adicione um nó AI Agent ou Basic LLM Chain, conecte um subnó OpenAI Chat Model e selecione a credencial.
-
Defina o modelo por ID. Em Model, mude o modo de From List para ID e digite
broadnet/glm-5.3. -
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.
-
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.
-
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.
