---
title: "LangChain ChatOpenAI com base_url personalizada | BroadRouter"
description: "Conecte o ChatOpenAI do LangChain à BroadNet Inference com base_url e api_key, e veja o que o LangChain mantém e o que descarta dos modelos de raciocínio."
url: https://broadrouter.com/pt/guides/langchain-openai-base-url/
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/langchain-openai-base-url/) (atualizado em 2026-11-16).

# Como usar o LangChain com a BroadNet Inference

Atualizado em 2026-11-16

Instale o langchain-openai e crie o ChatOpenAI com base\_url definida como https://inference.broadnet.ai/v1, api\_key com a sua chave da BroadNet e um ID de modelo da BroadNet, por exemplo broadnet/glm-5.3. Invoke, streaming e chains com tool calling passam a rodar por chat completions. Evite recursos exclusivos da Responses API e deixe espaço para o raciocínio em max\_tokens.

O `ChatOpenAI` do LangChain aceita qualquer endpoint via `base_url`. Isso funciona com a BroadNet Inference porque ela usa o formato padrão de chat completions. Se você chama a API diretamente, veja [o guia do SDK Python](https://broadrouter.com/pt/guides/openai-python-sdk/).

## Instalação

As versões atuais do `langchain-openai` (1.x) exigem Python 3.11 ou mais recente.

```bash
pip install -U langchain-openai
export BROADNET_API_KEY='paste-the-key-once'
```

## Conexão

```python
import os
from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="broadnet/glm-5.3",
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
    max_tokens=2000,  # reasoning counts toward this limit
)

print(llm.invoke("Summarise the CAP theorem in two sentences.").content)
```

`openai_api_base` é um alias de `base_url`. Sem nenhum dos dois, o LangChain lê `OPENAI_API_BASE`, e depois o cliente `openai` por baixo lê `OPENAI_BASE_URL`. O comentário no código lembra que o raciocínio conta para o limite de `max_tokens`.

## O que você precisa saber

-   **O texto do raciocínio não é mantido.** A documentação do LangChain diz que o `ChatOpenAI` segue a especificação oficial da OpenAI e não mantém campos fora do padrão, como `reasoning_content`. Você recebe a resposta final, que costuma ser o que uma chain precisa.
-   **Deixe espaço para o raciocínio.** GLM 5.3, DeepSeek V4.1 Flash e Qwen3.8 27B raciocinam antes de responder. Um `max_tokens` pequeno pode devolver uma resposta vazia. [Por que as respostas vêm vazias](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/).
-   **Usage no streaming.** Quando você configura o endpoint com `OPENAI_BASE_URL`, o LangChain desliga `stream_usage` por padrão. Passe `stream_usage=True` se quiser a contagem de tokens durante o streaming. A documentação da BroadNet diz que o usage chega no último chunk quando é solicitado.
-   **Fique em chat completions.** A BroadNet oferece `/v1/chat/completions`, não a Responses API. Segundo a documentação do LangChain, o `ChatOpenAI` muda para a Responses API quando você usa as ferramentas nativas da OpenAI (web search, file search, code interpreter e similares), estado de conversa ou o parâmetro `reasoning`. Deixe isso de fora e não defina `use_responses_api=True`.
-   **Nome do limite de tokens.** Segundo a documentação do LangChain, `max_tokens` é convertido internamente em `max_completion_tokens`. A documentação da BroadNet descreve `max_tokens`. Se um limite parecer ignorado, confira a requisição que o seu app realmente envia.

## Qual modelo para cada chain

| Chain | Modelo |
| --- | --- |
| Tool calling e saída estruturada | `broadnet/glm-5.3` |
| Documentos longos e agentes, plano ilimitado | `broadnet/deepseek-v4.1-flash` |
| Texto em árabe ou imagens | `broadnet/qwen3.8-27b` |

[Veja os preços de todos os modelos](https://broadrouter.com/pt/pricing/).

## Solução de problemas

-   **401.** A chave está errada, expirou ou ficou sem cota de pagamento por uso. Se você não passou `api_key`, o LangChain usou `OPENAI_API_KEY`, que pode conter uma chave da OpenAI.
-   **404 ou “not found”.** Confira se `base_url` termina em `/v1` e se nada está desviando a chamada para a Responses API (veja acima). Depois confira se o ID do modelo é exatamente o da BroadNet, com o prefixo `broadnet/`. Modelos pagos exigem uma recarga; o crédito de $5 cobre só `broadnet/gemma-4-26b-a4b` e os dois modelos Transcribe.
-   **`content` vazio.** O raciocínio consumiu o orçamento. Aumente `max_tokens`. [Por que as respostas vêm vazias](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/).
-   **As chamadas de ferramenta nunca acontecem.** Use `broadnet/glm-5.3` ou `broadnet/qwen3.8-27b`. A documentação da BroadNet lista ferramentas só para esses dois.
-   **429 em chains em lote ou paralelas.** Uma chave de pagamento por uso permite 30 requisições por minuto e 4 ao mesmo tempo. Defina `max_concurrency` na configuração do runnable para `batch()`. Veja [códigos de erro 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.

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

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

[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

### No ChatOpenAI, uso base\_url ou openai\_api\_base?

Tanto faz. openai\_api\_base é um alias de base\_url. Se você não passar nenhum dos dois, o LangChain confere OPENAI\_API\_BASE e, depois, o client openai lê OPENAI\_BASE\_URL.

### Dá para configurar o endpoint da BroadNet só com variáveis de ambiente?

Sim. Defina OPENAI\_BASE\_URL como https://inference.broadnet.ai/v1 e OPENAI\_API\_KEY com a sua chave da BroadNet, e crie o ChatOpenAI passando só o ID do modelo. Passe stream\_usage=True se quiser a contagem de tokens durante o streaming.

### Por que o LangChain descarta o reasoning\_content das respostas da BroadNet?

A documentação do LangChain diz que o ChatOpenAI segue a especificação oficial da OpenAI e não extrai campos fora do padrão, como reasoning\_content. A resposta final em content chega normalmente.

### O ChatOpenAI com a BroadNet suporta tool calling?

Sim, via bind\_tools, nos modelos para os quais a BroadNet lista ferramentas. Para tool calling e with\_structured\_output, use broadnet/glm-5.3 ou broadnet/qwen3.8-27b.

## Guias relacionados

-   [Como usar o SDK Python da OpenAI com a BroadNet Inference](https://broadrouter.com/pt/guides/openai-python-sdk/)
-   [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/)
-   [Rodar o OpenAI Agents SDK na BroadNet Inference](https://broadrouter.com/pt/guides/openai-agents-sdk-custom-provider/)
-   [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-langchain-openai-base-url&utm_content=page-cta) ·

**Fontes**

-   [Documentação do LangChain, integração ChatOpenAI (conferido em 2026-11-14)](https://docs.langchain.com/oss/python/integrations/chat/openai)
-   [PyPI, pacote langchain-openai (1.8, Python 3.11+, conferido em 2026-11-14)](https://pypi.org/project/langchain-openai/)
-   [Código-fonte do langchain-openai, resolução do base URL no ChatOpenAI (conferido em 2026-11-16)](https://github.com/langchain-ai/langchain/blob/master/libs/partners/openai/langchain_openai/chat_models/base.py)
-   [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-langchain-openai-base-url&utm_content=sources)
