BroadRouter

Conectar o Langflow à BroadNet Inference

Atualizado em

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:

    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.

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.
  • 429. Uma chave de pagamento por uso permite 30 requisições por minuto e 4 em andamento. Veja erros e novas tentativas.

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.

Ler em MarkdownPerguntar ao ChatGPTPerguntar ao ClaudePerguntar ao Perplexity