Recursos para Desenvolvedores

LibreChat

Configure um endpoint personalizado do LibreChat para o RunAPI, monte seu YAML no Docker, reinicie e verifique uma conversa.

Ver Markdown

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.

Instalar LibreChat

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

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.

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. Para campos de requisição e resposta, use a Referência da API Chat Completions.