---
title: "LibreChat: custom endpoint no librechat.yaml (API OpenAI)"
description: "Adicione a BroadNet Inference ao LibreChat como custom endpoint compatível com a OpenAI no librechat.yaml, com a chave no .env, lista de modelos e title model."
url: https://broadrouter.com/pt/guides/librechat-custom-endpoint/
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/librechat-custom-endpoint/) (atualizado em 2026-11-16).

# Adicionar a BroadNet Inference ao LibreChat como custom endpoint

Atualizado em 2026-11-16

No librechat.yaml, adicione em endpoints.custom uma entrada com name BroadNet, apiKey apontando para uma variável de ambiente como BROADNET\_API\_KEY, baseURL https://inference.broadnet.ai/v1 e models.default com IDs da BroadNet como broadnet/glm-5.3. Coloque a chave no .env, monte o arquivo no container se usar Docker e reinicie o LibreChat. O LibreChat adiciona /chat/completions ao base URL sozinho.

O LibreChat é um app de chat open source que aceita serviços compatíveis com a OpenAI como **custom endpoints**. Você os define no `librechat.yaml`, guarda as chaves no `.env` e, no Docker, monta o arquivo YAML no container. O BroadRouter é o site da própria BroadNet; os passos seguem o [guia de custom endpoints do LibreChat](https://www.librechat.ai/docs/quick_start/custom_endpoints).

## Configuração

1.  **Monte o librechat.yaml (só Docker).** Copie `docker-compose.override.yml.example` para `docker-compose.override.yml` e confira se o volume está ativo:

```yaml
services:
  api:
    volumes:
      - type: bind
        source: ./librechat.yaml
        target: /app/librechat.yaml
```

2.  **Adicione o endpoint** ao `librechat.yaml` na raiz do projeto, em `endpoints.custom`:

```yaml
endpoints:
  custom:
    - name: 'BroadNet'
      apiKey: '${BROADNET_API_KEY}'
      baseURL: 'https://inference.broadnet.ai/v1'
      models:
        default:
          - 'broadnet/glm-5.3'
          - 'broadnet/qwen3.8-27b'
          - 'broadnet/deepseek-v4.1-flash'
          - 'broadnet/gemma-4-26b-a4b'
        fetch: false
      titleConvo: true
      titleModel: 'broadnet/gemma-4-26b-a4b'
      modelDisplayLabel: 'BroadNet'
```

Mantenha as chaves de nível superior que o seu arquivo já tem, como `version`.

3.  **Defina a chave** no `.env`:

```bash
BROADNET_API_KEY=your-broadnet-key
```

4.  **Reinicie o LibreChat.** Com Docker: `docker compose down && docker compose up -d`. Em uma instalação local, reinicie com `npm run backend`. A BroadNet aparece então no seletor de endpoints.

## Observações sobre os campos

-   **baseURL.** O LibreChat adiciona `/chat/completions` sozinho, então use a raiz `/v1` acima. Não defina `directEndpoint: true`; essa opção é para um baseURL que já é a URL completa de completions.
-   **fetch: false.** É o padrão do LibreChat; definimos para deixar a escolha visível. A documentação da BroadNet descreve `GET /v1/models` como metadados públicos de catálogo para monitoramento, então listar os modelos em `default` é mais previsível.
-   **titleModel.** O LibreChat escreve um título para cada chat com uma requisição extra. Um modelo pequeno, barato e sem raciocínio deixa essa chamada curta. A documentação da BroadNet não lista raciocínio para o Gemma 4 VL 26B.
-   **user\_provided.** Defina `apiKey: 'user_provided'` se cada usuário deve informar a própria chave da BroadNet na interface. O LibreChat guarda a chave de cada usuário criptografada e a pede na primeira vez que o usuário escolhe o endpoint.
-   **Nome único.** Um segundo endpoint com o mesmo nome, sem diferenciar maiúsculas e minúsculas, substitui o primeiro sem aviso. Se você já tem uma entrada chamada BroadNet, renomeie uma delas.
-   **Nada de chave literal.** A documentação do LibreChat recomenda a referência `${VAR}` em vez de uma chave digitada no `librechat.yaml`, onde ficaria no arquivo em texto puro.

## Qual modelo escolher

| Uso | Modelo |
| --- | --- |
| Chat padrão, ferramentas, JSON | [GLM 5.3](https://broadrouter.com/pt/models/glm-5.3/) |
| Imagens e árabe | [Qwen3.8 27B](https://broadrouter.com/pt/models/qwen3.8-27b/) |
| Documentos longos, contexto de 1M | [DeepSeek V4.1 Flash](https://broadrouter.com/pt/models/deepseek-v4.1-flash/) |
| Títulos e respostas rápidas | [BroadNet Gemma 4 VL 26B](https://broadrouter.com/pt/models/gemma-4-vl-26b/) |

Destes modelos, só o Gemma 4 VL 26B roda com o crédito inicial de $5, que também cobre os dois modelos Transcribe. Compare os preços na [página de preços](https://broadrouter.com/pt/pricing/).

## Solução de problemas

-   **O endpoint não aparece.** Confira se `name`, `baseURL`, `apiKey` e `models.default` estão escritos corretamente e indentados dentro de `endpoints.custom`. O LibreChat descarta entradas incompletas sem linha de log. No Docker, confirme que o bind mount não está comentado no `docker-compose.override.yml`.
-   **“Missing API Key for BroadNet”** (tradução: chave de API ausente para a BroadNet). `BROADNET_API_KEY` não está no `.env`, ou o LibreChat não foi reiniciado. O endpoint continua aparecendo; o erro só surge quando você envia uma mensagem.
-   **401 do provedor.** A chave está errada, expirou ou a cota de pagamento por uso acabou.
-   **Erros de modelo.** Cada ID precisa bater exatamente com o da BroadNet, com o prefixo `broadnet/`. GLM 5.3, Qwen3.8 27B e DeepSeek V4.1 Flash exigem uma recarga.
-   **Respostas vazias.** DeepSeek V4.1 Flash, GLM 5.3 e Qwen3.8 27B raciocinam primeiro, e o raciocínio conta para `max_tokens`. Se você definiu uma saída máxima baixa nos parâmetros do LibreChat, aumente-a. [Por que as respostas vêm vazias](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/).
-   **429 com muitos usuários.** Uma chave de pagamento por uso permite 30 requisições por minuto e 4 ao mesmo tempo, divididas entre todos que usam o endpoint. As requisições de título também contam. Chaves `user_provided` distribuem a carga. Veja [erros e novas tentativas](https://broadrouter.com/pt/guides/errors-and-retries/).
-   **Chaves de plano.** Uma [sessão de plano ilimitado](https://broadrouter.com/pt/guides/unlimited-llm-api-sessions/) roda uma requisição de cada vez e não pode ser compartilhada, então não serve para um LibreChat com vários usuários.

## Termos neste guia

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

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

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

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

## Perguntas frequentes

### Por que o meu endpoint da BroadNet não aparece no LibreChat?

O LibreChat descarta um custom endpoint sem erro nem linha de log se name, baseURL, apiKey ou models.default estiver faltando ou com erro de digitação. No Docker, confira também se o librechat.yaml está montado em /app/librechat.yaml e se você reiniciou.

### Cada usuário pode usar a própria chave da BroadNet?

Sim. Defina apiKey como user\_provided. O LibreChat então pede a chave a cada usuário na primeira vez que ele escolhe o endpoint e a guarda criptografada.

### Por que o LibreChat mostra "Missing API Key for BroadNet"?

A variável referenciada em apiKey não está definida no .env. O endpoint continua aparecendo no seletor, e o erro só surge quando você envia uma mensagem. Adicione a variável e reinicie o LibreChat.

### O baseURL do LibreChat deve incluir /chat/completions?

Não. Por padrão, o LibreChat adiciona /chat/completions ao baseURL. Use https://inference.broadnet.ai/v1. Só defina directEndpoint como true quando a URL informada já for o endpoint completo de completions.

## Guias relacionados

-   [Como conectar o Open WebUI à BroadNet Inference](https://broadrouter.com/pt/guides/open-webui-openai-api/)
-   [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/)
-   [Restrinja chaves de API aos seus servidores com lista de IPs](https://broadrouter.com/pt/guides/api-keys-ip-allow-lists/)
-   [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-librechat-custom-endpoint&utm_content=page-cta) ·

**Fontes**

-   [Documentação do LibreChat, quick start de Custom Endpoints (conferido em 2026-11-14)](https://www.librechat.ai/docs/quick_start/custom_endpoints)
-   [Documentação do LibreChat, estrutura do objeto Custom Endpoint (conferido em 2026-11-14)](https://www.librechat.ai/docs/configuration/librechat_yaml/object_structure/custom_endpoint)
-   [Referência da API da BroadNet Inference (conferido em 2026-11-16) (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-guides-librechat-custom-endpoint&utm_content=sources)
