---
title: "Flowise: nó OpenAI Custom Model com Base Path | BroadRouter"
description: "Use a BroadNet Inference em chatflows do Flowise com o nó OpenAI Custom Model, um Base Path, uma credencial OpenAI API e o nome do modelo da BroadNet."
url: https://broadrouter.com/pt/guides/flowise-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/flowise-openai-compatible/) (atualizado em 2026-11-16).

# Conectar o Flowise à BroadNet Inference (OpenAI Custom Model)

Atualizado em 2026-11-16

Em um chatflow do Flowise, adicione o nó de chat model OpenAI Custom Model. Conecte uma credencial OpenAI API com a sua chave da BroadNet, digite em Model Name um ID da BroadNet como broadnet/glm-5.3 e, em Additional Parameters, defina Base Path como https://inference.broadnet.ai/v1. O nó usa chat completions. Para agentes que chamam ferramentas, escolha GLM 5.3 ou Qwen3.8 27B.

O Flowise é um construtor open source e low-code de apps e agentes com LLM. O nó de chat model **OpenAI Custom Model** foi feito para APIs compatíveis com a OpenAI: você digita o nome do modelo e define um base path. A BroadNet Inference oferece chat completions em `https://inference.broadnet.ai/v1`, então é esse o nó a usar. O BroadRouter é o site da própria BroadNet; os passos seguem o código-fonte do nó no Flowise 3.1.4, porque a documentação do Flowise não tem uma página sobre esse nó.

## Configuração

1.  **Crie uma credencial.** No Flowise, abra **Credentials**, adicione uma credencial **OpenAI API**, dê o nome “BroadNet” e cole a sua chave da BroadNet em **OpenAI Api Key**.
    
2.  **Adicione o nó.** Em um chatflow, adicione **Chat Models → OpenAI Custom Model**.
    
3.  **Preencha o nó:**
    
    | Campo | Valor |
    | --- | --- |
    | Connect Credential | a credencial BroadNet |
    | Model Name | `broadnet/glm-5.3` |
    | Temperature | 0.9 por padrão; abaixe para extração |
    | Streaming (Additional Parameters) | ligado (o padrão) |
    | Max Tokens (Additional Parameters) | 4000 |
    | Base Path (Additional Parameters) | `https://inference.broadnet.ai/v1` |
    
4.  **Conecte o nó** a um nó de chain ou de agente, salve e envie uma mensagem de teste no painel de chat. Se vier resposta, a chave, a URL e o nome do modelo estão certos.
    

## O que cada campo faz

-   **Model Name** é enviado como ID do modelo. Digite o ID da BroadNet com o prefixo `broadnet/`. O nó não busca uma lista de modelos, então o `/v1/models` da BroadNet, que listava só os modelos de transcrição quando conferimos, em 16 de novembro de 2026, não atrapalha.
-   **Base Path** vira a base URL do cliente. O Flowise acrescenta `/chat/completions`.
-   **Max Tokens** é enviado como `max_tokens`. DeepSeek V4.1 Flash, GLM 5.3 e Qwen3.8 27B raciocinam antes de responder, e o raciocínio conta para esse limite, então não use um valor baixo.
-   **Base Options** aceita headers em JSON para incluir em toda requisição. A BroadNet não precisa de nenhum.

## Por que não o nó ChatOpenAI padrão?

O nó ChatOpenAI também tem um campo Base Path, mas no Flowise 3.1.4 o Model Name dele é uma lista suspensa preenchida por um método `listModels`, com `gpt-4o-mini` como padrão. Já o nó OpenAI Custom Model tem um Model Name de texto livre, e o código-fonte o descreve como feito para uma “OpenAI Chat compatible API” (tradução: API compatível com o OpenAI Chat), que é o que a BroadNet oferece.

## Qual modelo escolher

| Fluxo | Modelo |
| --- | --- |
| Agentes com ferramentas, parsers de saída estruturada | `broadnet/glm-5.3` |
| Agentes que leem imagens ou texto em árabe | `broadnet/qwen3.8-27b` |
| Chains de conversa e de recuperação, documentos longos | `broadnet/deepseek-v4.1-flash` |
| Testar o Flowise com o crédito inicial | `broadnet/gemma-4-26b-a4b` (contexto de 32.768 tokens) |

A documentação da BroadNet lista ferramentas e saída estruturada só para GLM 5.3 e Qwen3.8 27B. [Preços de todos os modelos](https://broadrouter.com/pt/pricing/).

## Como testamos

Não rodamos um servidor Flowise. Em 2026-11-15 lemos o código-fonte do nó OpenAI Custom Model na tag flowise@3.1.4 e montamos o mesmo objeto `ChatOpenAI` que ele monta, com `@langchain/openai` 1.2.5, a versão fixada pelo Flowise 3.1.4. Enviamos uma mensagem com streaming e uma chamada de ferramenta para um servidor mock local que imita o formato de chat completions da BroadNet. As duas requisições foram para `/v1/chat/completions` com o ID do modelo `broadnet/glm-5.3` sem alteração, uma chave Bearer, `max_tokens: 4000`, `temperature: 0.9` e `stream: true`, e a chamada de ferramenta voltou já interpretada. Não tínhamos uma chave da BroadNet, então não testamos a saída real dos modelos. Os rótulos dos campos vêm do código-fonte; confira na sua versão do Flowise.

## Solução de problemas

-   **401.** A credencial tem a chave errada, ou a chave expirou ou ficou sem cota.
-   **404.** Base Path precisa terminar em `/v1`. Model Name precisa ser exatamente o ID da BroadNet. 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 Max Tokens. [Por que as respostas vêm vazias](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/).
-   **O agente responde sem usar ferramentas.** Troque para `broadnet/glm-5.3` ou `broadnet/qwen3.8-27b`.
-   **429 sob carga.** Uma chave de pagamento por uso permite 30 requisições por minuto e 4 em andamento. Veja [erros e novas tentativas](https://broadrouter.com/pt/guides/errors-and-retries/).

## Termos neste guia

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

[Streaming](https://broadrouter.com/pt/glossary/streaming/)

Streaming é uma forma de devolver a resposta de um modelo de linguagem em pequenos pedaços enquanto ela ainda está sendo gerada, em vez de uma resposta única no final. APIs compatíveis com a OpenAI fazem streaming via server-sent events quando a requisição define stream como true.

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

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

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

[Chat Completions API](https://broadrouter.com/pt/glossary/chat-completions-api/)

A Chat Completions API é o endpoint HTTP da OpenAI, POST /v1/chat/completions, que recebe o nome de um modelo e uma lista de mensagens marcadas com papéis e devolve a próxima mensagem do modelo. O formato da requisição e da resposta virou o padrão comum que provedores e SDKs compatíveis com a OpenAI reutilizam.

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

## Perguntas frequentes

### Qual nó do Flowise devo usar com a BroadNet?

OpenAI Custom Model (chatOpenAICustom). O código-fonte o descreve como um modelo personalizado que usa uma API compatível com o OpenAI Chat. Model Name é um campo de texto livre, então você pode digitar um ID da BroadNet, e Base Path muda a URL.

### Onde fica o campo Base Path no Flowise?

É um campo opcional do nó OpenAI Custom Model, em Additional Parameters. Defina como https://inference.broadnet.ai/v1, com o /v1 e nenhum caminho depois.

### Qual credencial o nó OpenAI Custom Model usa?

Uma credencial OpenAI API (openAIApi). Crie uma com a sua chave da BroadNet como API key. O Flowise a envia como token Bearer para o Base Path.

### Por que a temperature padrão parece alta?

O nó vem com temperature 0.9 por padrão. Abaixe para fluxos de extração ou classificação.

## Guias relacionados

-   [Como usar a BroadNet Inference no n8n (credencial OpenAI, Base URL)](https://broadrouter.com/pt/guides/n8n-openai-compatible/)
-   [BroadNet Inference no Dify com o plugin OpenAI-API-compatible](https://broadrouter.com/pt/guides/dify-openai-api-compatible/)
-   [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-flowise-openai-compatible&utm_content=page-cta) ·

**Fontes**

-   [Código-fonte do Flowise, nó OpenAI Custom Model (ChatOpenAICustom.ts) na tag flowise@3.1.4 (conferido em 2026-11-15)](https://github.com/FlowiseAI/Flowise/blob/flowise%403.1.4/packages/components/nodes/chatmodels/ChatOpenAICustom/ChatOpenAICustom.ts)
-   [Releases do Flowise no GitHub, a mais recente é flowise@3.1.4 (conferido em 2026-11-15)](https://github.com/FlowiseAI/Flowise/releases)
-   [Referência da API da BroadNet Inference (conferido em 2026-11-15) (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-guides-flowise-openai-compatible&utm_content=sources)
