---
title: "n8n com Base URL compatível com a OpenAI e OpenAI Chat Model"
description: "Aponte a credencial OpenAI do n8n para a BroadNet Inference no campo Base URL e use o nó OpenAI Chat Model por ID, com Use Responses API desligado."
url: https://broadrouter.com/pt/guides/n8n-openai-compatible/
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/n8n-openai-compatible/) (atualizado em 2026-11-16).

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

Atualizado em 2026-11-16

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](https://broadrouter.com/pt/pricing/). Para áudio, o nó HTTP Request do n8n pode enviar arquivos para `/v1/audio/transcriptions`; o [guia de fala para texto em árabe](https://broadrouter.com/pt/guides/arabic-speech-to-text-api/) 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](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/).
-   **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](https://broadrouter.com/pt/guides/errors-and-retries/).
-   **Execuções em paralelo com uma chave de plano.** Uma [sessão do plano ilimitado](https://broadrouter.com/pt/guides/unlimited-llm-api-sessions/) 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](https://broadrouter.com/pt/guides/langchain-openai-base-url/), base dos nós de IA do n8n.

## Termos neste guia

[Base URL (URL base)](https://broadrouter.com/pt/glossary/base-url/)

A base URL é o endereço raiz fixo de uma API, como https://api.example.com/v1, que um cliente coloca antes de cada caminho de endpoint, como /chat/completions. Nos SDKs compatíveis com a OpenAI, trocar a base URL, junto com a chave de API e o ID do modelo, aponta o mesmo código para outro provedor.

[Token](https://broadrouter.com/pt/glossary/token/)

Um token é a unidade de texto que um modelo de linguagem lê e escreve: uma palavra, parte de uma palavra, um sinal de pontuação ou uma sequência de bytes gerada pelo tokenizador do modelo. As APIs de LLM contam, limitam e normalmente cobram o uso em tokens.

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

[Agente de IA (AI agent)](https://broadrouter.com/pt/glossary/agent/)

Um agente de IA é um sistema em que um modelo de linguagem conduz os próprios passos rumo a um objetivo: decide quais ferramentas chamar, lê os resultados e repete até produzir uma resposta final ou atingir um limite. Um script fixo que chama um modelo em pontos definidos costuma ser chamado de workflow.

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

[Saída estruturada (structured output)](https://broadrouter.com/pt/glossary/structured-output/)

Saída estruturada é um recurso de APIs de LLM que restringe a resposta de um modelo a um formato definido pelo desenvolvedor, normalmente um JSON Schema, para que o código consiga interpretá-la de forma confiável. É mais rigorosa que o JSON mode, que garante um JSON válido, mas não uma estrutura específica.

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

## Guias relacionados

-   [Transcrever áudios do WhatsApp no n8n](https://broadrouter.com/pt/guides/n8n-whatsapp-voice-note-transcription/)
-   [Como usar o LangChain com a BroadNet Inference](https://broadrouter.com/pt/guides/langchain-openai-base-url/)
-   [API de transcrição de áudio em árabe, passo a passo](https://broadrouter.com/pt/guides/arabic-speech-to-text-api/)
-   [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-n8n-openai-compatible&utm_content=page-cta) ·

**Fontes**

-   [Documentação do n8n, nó OpenAI Chat Model (conferido em 2026-11-14)](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.lmchatopenai/)
-   [Documentação do n8n, problemas comuns do OpenAI Chat Model (conferido em 2026-11-14)](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.lmchatopenai/common-issues/)
-   [Documentação do n8n, credenciais OpenAI (conferido em 2026-11-14)](https://docs.n8n.io/integrations/builtin/credentials/openai/)
-   [Código-fonte do n8n, campos da credencial OpenAI (conferido em 2026-11-14)](https://github.com/n8n-io/n8n/blob/master/packages/nodes-base/credentials/OpenAiApi.credentials.ts)
-   [Código-fonte do n8n, nó OpenAI Chat Model (conferido em 2026-11-14)](https://github.com/n8n-io/n8n/blob/master/packages/@n8n/nodes-langchain/nodes/llms/LMChatOpenAi/LmChatOpenAi.node.ts)
-   [Referência da API da BroadNet Inference (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-guides-n8n-openai-compatible&utm_content=sources)
