LangChain com um base URL personalizado

Python, todos os modelos

pip install -U langchain-openai

Python, Claude no ChatAnthropic

pip install -U langchain-anthropic

JavaScript

npm install @langchain/openai @langchain/anthropic @langchain/core

from langchain_anthropic import ChatAnthropic

llm = ChatAnthropic(
    model="claude-opus-5.5",
    base_url="https://aigrow.gg",
    api_key="ag_your_key_here",
    max_tokens=1024,
)

import { ChatOpenAI } from '@langchain/openai';
import { ChatAnthropic } from '@langchain/anthropic';

const gpt = new ChatOpenAI({
  model: 'gpt-6-astra',
  apiKey: 'ag_your_key_here',
  configuration: { baseURL: 'https://aigrow.gg/v1' },
});

const claude = new ChatAnthropic({
  model: 'claude-opus-5.5',
  apiKey: 'ag_your_key_here',
  anthropicApiUrl: 'https://aigrow.gg',
});

export OPENAI_API_BASE=https://aigrow.gg/v1
export OPENAI_API_KEY=ag_your_key_here
export ANTHROPIC_BASE_URL=https://aigrow.gg
export ANTHROPIC_API_KEY=ag_your_key_here

404 ao adicionar ferramentas ou raciocínio

O ChatOpenAI passou a chamada para a Responses API, algo que faz sozinho para ferramentas integradas, definições de raciocínio e alguns modelos GPT. use_responses_api=False, como no bloco, mantém todas as chamadas em chat completions.

404 no ChatAnthropic

O base_url termina em /v1. O ChatAnthropic acrescenta /v1/messages por si, pelo que deve ser https://aigrow.gg.

A chave é enviada para a OpenAI ou a Anthropic

O base URL não chegou ao modelo. Passe base_url diretamente ao ChatOpenAI ou ao ChatAnthropic; tem prioridade sobre todas as variáveis de ambiente.

A minha ferramenta indica 401 ou erro de autenticação

A chave está em falta ou foi escrita incorretamente. Copie-a de novo em Acesso à API no painel e certifique-se de que é enviada como chave, e não como nome de modelo. Uma chave revogada falha da mesma forma: crie uma nova e substitua-a.

Recebo 402 ou uma mensagem sobre crédito

O seu saldo está vazio. Abra Acesso à API no painel, resgate um código ou compre outro pacote e o pedido seguinte será processado. Não é preciso mudar mais nada.

Aparece 404 ou Unknown model

O modelo tem de ser um dos que o endpoint disponibiliza, por exemplo claude-opus-5.5. A grafia própria do fornecedor também funciona (claude-opus-5-5, anthropic/claude-opus-5.5), mas um id com data ou qualquer modelo fora do catálogo é rejeitado antes de o pedido ser encaminhado e nada é cobrado. Peça GET /v1/models com a sua chave para obter a lista atual, ou consulte os ids na lista de preços.

Os pedidos são rejeitados com 429

A capacidade do endpoint é partilhada por todos os clientes: cerca de 20 pedidos por minuto e 4 em simultâneo. Cada resposta 429 inclui um cabeçalho retry-after, e os SDKs da OpenAI e da Anthropic esperam esse tempo e voltam a tentar por conta própria. Num ciclo seu, aguarde os segundos indicados ou reduza a concorrência.

O modelo está indisponível neste momento

Um 404 que indica que o modelo não está disponível neste momento significa que ele está brevemente em baixo no fornecedor de origem, e não um problema com a sua chave ou saldo. Tente novamente daqui a pouco ou envie o pedido para outro modelo.

Recebo um 502 ou 503

Uma falha transitória na origem ou na configuração, sem qualquer cobrança no seu saldo. Repita o pedido; se continuar a falhar, contacte-nos através da loja e vamos analisar.

O LangChain é faturado por token às taxas de crédito da lista de preços. Um agente volta a enviar a conversa inteira a cada passo, por isso uma tarefa longa custa mais do que a última mensagem sugere; o registo de atividade em Acesso à API mostra quanto custou cada pedido.

Como defino o base_url no ChatOpenAI do LangChain?

Passe base_url="https://aigrow.gg/v1" e api_key com a sua chave ao criar o ChatOpenAI. openai_api_base é outro nome para a mesma definição, e OPENAI_API_BASE ou OPENAI_BASE_URL no ambiente também funcionam.

Como defino um base URL para o ChatAnthropic?

Passe base_url="https://aigrow.gg" em Python, ou anthropicApiUrl em JavaScript. Não inclua /v1, porque o cliente acrescenta /v1/messages por si. ANTHROPIC_BASE_URL no ambiente também funciona.

Porquê definir use_responses_api=False?

O ChatOpenAI passa sozinho para a Responses API quando usa ferramentas integradas, definições de raciocínio e alguns modelos GPT, e o endpoint só disponibiliza chat completions. Com False, todas as chamadas ficam em chat completions.

O ChatOpenAI pode executar modelos Claude?

Sim. O endpoint também disponibiliza modelos Claude no protocolo da OpenAI, pelo que model="claude-opus-5.5" funciona no ChatOpenAI com o mesmo base_url. O ChatAnthropic é a forma de os enviar no protocolo da Anthropic.

Fontes: LangChain ChatOpenAI · LangChain ChatAnthropic reference · LangChain ChatOpenAI for JavaScript. Consultado em 21 de outubro de 2026.