---
title: LibreChat | RunAPI
description: Configure um endpoint personalizado do LibreChat para o RunAPI, monte
  seu YAML no Docker, reinicie e verifique uma conversa.
url: https://runapi.ai/pt-BR/docs/resources/application-practices/librechat.md
canonical: https://runapi.ai/pt-BR/docs/resources/application-practices/librechat
locale: pt-BR
---

> Versão HTML: https://runapi.ai/pt-BR/docs/resources/application-practices/librechat
> Índice do site para agentes: https://runapi.ai/llms.txt

# LibreChat

Os endpoints personalizados do LibreChat são configurações de implantação, e não um
formulário de conexão por usuário. Você precisa de acesso aos arquivos de implantação do LibreChat e de
uma Chave de API padrão do RunAPI obtida no [Guia de
Autenticação](https://runapi.ai/pt-BR/docs/guides/authentication.md).

## Instalar LibreChat

Instale o LibreChat com a [configuração local oficial][1] ou use sua
implantação existente. Conclua a instalação antes de adicionar o endpoint personalizado.



[1]: https://www.librechat.ai/docs/local

## Adicionar o endpoint RunAPI

Crie ou atualize `librechat.yaml` no diretório de implantação do LibreChat.
Substitua `YOUR_RUNAPI_MODEL_ID` por um identificador atual do [Catálogo
de Modelos](https://runapi.ai/pt-BR/models).

```yaml
version: 1.3.13
endpoints:
  custom:
    - name: "RunAPI"
      apiKey: "${RUNAPI_API_KEY}"
      baseURL: "https://runapi.ai/v1"
      models:
        default: ["YOUR_RUNAPI_MODEL_ID"]
        fetch: true
      titleConvo: true
      titleModel: "current_model"
      modelDisplayLabel: "RunAPI"
```

Armazene a chave em `.env`, não diretamente no arquivo YAML:

```shell
RUNAPI_API_KEY=YOUR_RUNAPI_API_TOKEN
```

Para Docker Compose, certifique-se de que `docker-compose.override.yml` monta o
arquivo de configuração:

```yaml
services:
  api:
    volumes:
      - ./librechat.yaml:/app/librechat.yaml
```

Reinicie o deployment do LibreChat após alterar qualquer um desses arquivos.

## Selecionar um modelo

`models.default` garante pelo menos um modelo conhecido. Com
`models.fetch: true`, o LibreChat também solicita o inventário de modelos
atual. Mantenha um identificador padrão válido mesmo quando a descoberta estiver
ativada, para que o endpoint permaneça utilizável caso a descoberta esteja temporariamente
indisponível.

## Verificar a conexão

Após reiniciar, selecione **RunAPI** no seletor de endpoints, escolha o
modelo configurado e envie `Reply with the word connected.` Uma resposta
normal confirma tanto a configuração do deployment quanto a requisição ao modelo.

## Solucionar problemas

* **RunAPI está ausente do seletor de endpoints:** valide o recuo do YAML, confirme que `docker-compose.override.yml` monta o arquivo e reinicie o contêiner da API.
* **O endpoint carrega, mas a autenticação falha:** confirme que `.env` define `RUNAPI_API_KEY` para o contêiner da API e recrie o contêiner se seu ambiente estiver desatualizado.
* **Nenhum modelo buscado aparece:** mantenha um identificador atual em `models.default`, confirme que `baseURL` termina em `/v1` e inspecione os logs do contêiner da API.
* **LibreChat ignora o YAML editado:** verifique se o caminho do host e o caminho do contêiner no ponto de montagem do volume apontam para o arquivo que você alterou.

Para o comportamento de protocolo compartilhado, use o [Início rápido da API
LLM](https://runapi.ai/pt-BR/docs/guides/llm-api/quickstart.md). Para campos de requisição e resposta, use a [Referência da API Chat
Completions](https://runapi.ai/pt-BR/docs/api/openai/chat-completions.md).

---

## Mais de RunAPI

- [Início](https://runapi.ai/pt-BR/.md)
- [Catálogo de modelos](https://runapi.ai/pt-BR/models.md)
- [Preços](https://runapi.ai/pt-BR/pricing.md)
- [Provedores](https://runapi.ai/pt-BR/models)
- [Documentação](https://runapi.ai/pt-BR/docs/guides)
- [SDKs](https://runapi.ai/pt-BR/sdk.md)
- [CLI](https://runapi.ai/pt-BR/cli.md)
- [Servidor MCP](https://runapi.ai/pt-BR/mcp.md)
- [Claude Code vs Cursor](https://runapi.ai/pt-BR/claude-code-vs-cursor.md)
- [Configuração da API do Cursor](https://runapi.ai/pt-BR/cursor-api-setup.md)
- [RunAPI vs OpenRouter](https://runapi.ai/pt-BR/openrouter-alternative.md)
- [Enterprise](https://runapi.ai/pt-BR/contact.md)
- [Contato](https://runapi.ai/pt-BR/contact.md)
- [Termos](https://runapi.ai/pt-BR/terms.md)
- [Privacidade](https://runapi.ai/pt-BR/privacy.md)
- [Índice do site para agentes](https://runapi.ai/llms.txt)

Contato: contact@runapi.ai

## Dados estruturados

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "pt-BR",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/pt-BR",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/pt-BR/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "pt-BR",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/pt-BR",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/pt-BRicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "pt-BR",
    "@type": "TechArticle",
    "headline": "LibreChat",
    "description": "Configure um endpoint personalizado do LibreChat para o RunAPI, monte seu YAML no Docker, reinicie e verifique uma conversa.",
    "url": "https://runapi.ai/pt-BR/docs/resources/application-practices/librechat",
    "mainEntityOfPage": "https://runapi.ai/pt-BR/docs/resources/application-practices/librechat"
  }
]
```