---
title: "Langflow: componente OpenAI com API base personalizada"
description: "Use a BroadNet Inference no Langflow com o campo OpenAI API Base do componente OpenAI e um nome de modelo digitado, e veja por que o OpenAI Compatible não a lista."
url: https://broadrouter.com/pt/guides/langflow-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/langflow-openai-compatible/) (atualizado em 2026-11-16).

# Conectar o Langflow à BroadNet Inference

Atualizado em 2026-11-16

No Langflow, adicione o componente OpenAI do bundle OpenAI. Digite em Model Name um ID da BroadNet como broadnet/glm-5.3, cole a sua chave da BroadNet e, nas configurações avançadas, defina OpenAI API Base como https://inference.broadnet.ai/v1. Não use o model provider OpenAI Compatible: ele lista modelos de /v1/models, e o da BroadNet lista só os modelos de transcrição.

O Langflow é um builder visual open source para agentes e flows de RAG. O componente **OpenAI** dele tem um campo **OpenAI API Base** que, nas palavras do próprio componente, permite “use other APIs” (tradução: usar outras APIs). A BroadNet Inference serve chat completions em `https://inference.broadnet.ai/v1`, então esse componente funciona com um ID de modelo da BroadNet digitado. O BroadRouter é o site da própria BroadNet; este guia segue a documentação do Langflow 1.13.x e o código-fonte do componente na v1.13.2.

## Configuração

1.  **Adicione o componente.** Em um flow, abra o painel de componentes e adicione **OpenAI** do bundle OpenAI. O Langflow 1.13.2 instala esse bundle junto com o pacote principal.
    
2.  **Model Name.** Clique no campo e digite `broadnet/glm-5.3`. Ele aceita valores personalizados, então você não fica limitado aos modelos da OpenAI da lista.
    
3.  **OpenAI API Key.** Cole a sua chave da BroadNet ou escolha uma variável global que a contenha.
    
4.  **Configurações avançadas.** Abra os controles do componente e defina:
    
    | Campo | Valor |
    | --- | --- |
    | OpenAI API Base | `https://inference.broadnet.ai/v1` |
    | Max Tokens | 4000 |
    
5.  **Rode.** Conecte um Chat Input e um Chat Output, abra o Playground e envie uma mensagem. Se vier uma resposta, as configurações estão certas.
    

## Duas verificações do Langflow que podem bloquear a BroadNet

O Langflow 1.13 vem com a proteção contra SSRF ativada por padrão. Duas regras importam:

-   **Chaves do ambiente do servidor.** Se a chave de API vem do ambiente do servidor (por exemplo, uma variável global carregada de uma variável de ambiente), o Langflow se recusa a enviá-la para um endpoint que não seja o padrão, a menos que o host esteja na lista de permitidos. O operador define:
    
    ```bash
    export LANGFLOW_PROVIDER_CREDENTIAL_ALLOWED_HOSTS=inference.broadnet.ai
    ```
    
    Uma chave digitada no componente não é afetada.
    
-   **Endereços privados.** Loopback e IPs privados são bloqueados, a menos que estejam em `LANGFLOW_SSRF_ALLOWED_HOSTS`. A BroadNet é um host HTTPS público, então isso só importa se você passar por um proxy local.
    

## Por que não o provedor OpenAI Compatible?

O Langflow 1.13 também tem um model provider **OpenAI Compatible** em **Settings → Model Providers**. A documentação dele diz que valida a conexão pela rota `/v1/models` do endpoint e oferece os modelos que encontra. Quando conferimos, em 16 de novembro de 2026, o `/v1/models` da BroadNet listava só `broadnet/cohere-transcribe-arabic` e `broadnet/cohere-transcribe`, então os modelos de chat não podem ser escolhidos ali. O nome de modelo digitado no componente OpenAI evita isso.

## Qual modelo escolher

| Flow | Modelo |
| --- | --- |
| Componente Agent com ferramentas | `broadnet/glm-5.3` |
| Flows com imagens ou texto em árabe, com ferramentas | `broadnet/qwen3.8-27b` |
| Flows com documentos longos, plano de preço fixo | `broadnet/deepseek-v4.1-flash` |
| Testar o Langflow 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 o GLM 5.3 e o Qwen3.8 27B. O **JSON Mode** do componente envia `response_format: {"type": "json_object"}`; use-o com esses dois modelos. [Preços de todos os modelos](https://broadrouter.com/pt/pricing/).

## Como testamos

Não rodamos a interface do Langflow. Em 2026-11-15 instalamos o `lfx` 1.13.2 e o bundle `lfx-openai`, cujo arquivo do componente OpenAI bate com o código-fonte da v1.13.2, e montamos o componente em Python contra um servidor mock local que imita o formato de chat completions da BroadNet. Com uma chave digitada e `LANGFLOW_SSRF_ALLOWED_HOSTS` definido para o mock local, a requisição foi para `/v1/chat/completions` com o ID do modelo `broadnet/glm-5.3` sem alteração, uma chave Bearer, `temperature: 0.1` e um `seed`. O valor de Max Tokens foi enviado como `max_completion_tokens`; a referência da API da BroadNet descreve `max_tokens`. Uma chave copiada do ambiente do servidor foi recusada até definirmos também `LANGFLOW_PROVIDER_CREDENTIAL_ALLOWED_HOSTS`. Não tínhamos uma chave da BroadNet, então não testamos a saída real dos modelos.

## Solução de problemas

-   **“Refusing to send a server-provisioned API credential”** (tradução: recusando enviar uma credencial de API fornecida pelo servidor). Adicione `inference.broadnet.ai` a `LANGFLOW_PROVIDER_CREDENTIAL_ALLOWED_HOSTS` ou digite a chave no componente.
-   **401.** A chave está errada, expirou ou ficou sem cota.
-   **404.** OpenAI API Base precisa terminar em `/v1`, e Model Name precisa bater exatamente com o ID da BroadNet. Modelos pagos exigem uma recarga; o crédito de $5 cobre só `broadnet/gemma-4-26b-a4b` e os dois modelos Transcribe.
-   **Respostas vazias.** No DeepSeek V4.1 Flash, no GLM 5.3 e no Qwen3.8 27B, o raciocínio conta para o limite de saída. Aumente Max Tokens. [Por que as respostas vêm vazias](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/).
-   **429.** 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.

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

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

[Chave de API (API key)](https://broadrouter.com/pt/glossary/api-key/)

Uma chave de API é uma string secreta que identifica e autoriza um cliente que chama uma API. As APIs de LLM normalmente a esperam em um cabeçalho Authorization: Bearer, e qualquer pessoa que tenha a chave pode fazer requisições cobradas da conta dona dela.

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

[Crédito pré-pago (prepaid credit)](https://broadrouter.com/pt/glossary/prepaid-credit/)

Crédito pré-pago é dinheiro adicionado a uma conta de API antes do uso. Cada requisição desconta o próprio custo do saldo e, quando o saldo acaba, as requisições cobradas por uso param até você fazer uma recarga. Ele limita o gasto ao que você já pagou.

## Perguntas frequentes

### Por que o provedor OpenAI Compatible não mostra o GLM 5.3 nem o Qwen?

A documentação do Langflow diz que esse provedor descobre os modelos pela rota /v1/models do endpoint. Quando conferimos, em 16 de novembro de 2026, o /v1/models da BroadNet listava só os dois modelos de transcrição, então os modelos de chat nunca aparecem. Use o componente OpenAI com um nome de modelo digitado.

### Posso digitar um modelo que não está na lista do componente OpenAI?

Sim. Model Name é uma combobox, o que, nas definições de input do Langflow, significa que o usuário pode informar um valor personalizado. Digite o ID completo da BroadNet, como broadnet/glm-5.3.

### Por que o Langflow se recusa a enviar a minha chave para a BroadNet?

O Langflow 1.13 não envia para um endpoint personalizado uma chave de API que vem do ambiente do servidor, a menos que o operador libere o host. Defina LANGFLOW\_PROVIDER\_CREDENTIAL\_ALLOWED\_HOSTS=inference.broadnet.ai ou cole a chave no componente.

### O componente OpenAI do Langflow usa a Responses API?

Não. Ele monta o ChatOpenAI do LangChain, que chama chat completions nas requisições normais. No nosso teste, ele chamou /v1/chat/completions.

## Guias relacionados

-   [Conectar o Flowise à BroadNet Inference (OpenAI Custom Model)](https://broadrouter.com/pt/guides/flowise-openai-compatible/)
-   [BroadNet Inference no Dify com o plugin OpenAI-API-compatible](https://broadrouter.com/pt/guides/dify-openai-api-compatible/)
-   [Como usar o LangChain com a BroadNet Inference](https://broadrouter.com/pt/guides/langchain-openai-base-url/)
-   [Por que um modelo de raciocínio devolve uma resposta vazia](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/)
-   [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-langflow-openai-compatible&utm_content=page-cta) ·

**Fontes**

-   [Documentação do Langflow 1.13.x, bundle OpenAI (conferido em 2026-11-15)](https://docs.langflow.org/bundles-openai)
-   [Documentação do Langflow 1.13.x, provedor OpenAI Compatible (conferido em 2026-11-15)](https://docs.langflow.org/bundles-openai-compatible)
-   [Código-fonte do Langflow, componente OpenAI na v1.13.2 (conferido em 2026-11-15)](https://github.com/langflow-ai/langflow/blob/v1.13.2/src/bundles/openai/src/lfx_openai/components/openai/openai_chat_model.py)
-   [Documentação do Langflow, proteção contra SSRF (conferido em 2026-11-16)](https://docs.langflow.org/api-keys-and-authentication#ssrf-protection)
-   [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-langflow-openai-compatible&utm_content=sources)
