Saltar al contenido
Recursos para desarrolladores
Recursos para desarrolladores

LibreChat

Configure un endpoint personalizado de LibreChat para RunAPI, móntelo como YAML en Docker, reinícielo y verifique un chat.

Los puntos de conexión personalizados de LibreChat son configuración de implementación, no un formulario de conexión por usuario. Necesita acceso a los archivos de implementación de LibreChat y una Clave de API estándar de RunAPI de la Guía de Autenticación.

Instalar LibreChat

Instale LibreChat con la configuración local oficial o use su implementación existente. Complete la instalación antes de agregar el punto de conexión personalizado.

Agregar el endpoint de RunAPI

Cree o actualice librechat.yaml en el directorio de implementación de LibreChat. Reemplace YOUR_RUNAPI_MODEL_ID con un identificador actual del 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"

Guarde la clave en .env, no directamente en el archivo YAML:

SHELL
RUNAPI_API_KEY=YOUR_RUNAPI_API_TOKEN

Para Docker Compose, asegúrese de que docker-compose.override.yml monte el archivo de configuración:

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

Reinicie el despliegue de LibreChat después de cambiar cualquiera de estos archivos.

Seleccionar un modelo

models.default garantiza al menos un modelo conocido. Con models.fetch: true, LibreChat también solicita el inventario de modelos actual. Mantén un identificador predeterminado válido incluso cuando el descubrimiento esté habilitado para que el endpoint siga siendo utilizable si el descubrimiento no está disponible temporalmente.

Verificar la conexión

Tras el reinicio, selecciona RunAPI en el selector de endpoints, elige el modelo configurado y envía Reply with the word connected. Una respuesta normal confirma tanto la configuración del despliegue como la solicitud al modelo.

Solución de problemas

  • RunAPI no aparece en el selector de endpoints: valida la sangría del YAML, confirma que docker-compose.override.yml monta el archivo y reinicia el contenedor de la API.
  • El endpoint carga pero la autenticación falla: confirma que .env define RUNAPI_API_KEY para el contenedor de la API y recrea el contenedor si su entorno está obsoleto.
  • No aparecen modelos obtenidos: mantén un identificador actual en models.default, confirma que baseURL termina en /v1 e inspecciona los registros del contenedor de la API.
  • LibreChat ignora el YAML editado: verifica que la ruta del host y la ruta del contenedor en el punto de montaje del volumen apunten al archivo que modificaste.

Para el comportamiento de protocolo compartido, use el Inicio rápido de la API LLM. Para los campos de solicitud y respuesta, use la Referencia de la API de Chat Completions.