LibreChat

LibreChat utiliza una puerta de enlace como bloque endpoints.custom en librechat.yaml — cuatro campos obligatorios, la clave desde .env y un reinicio antes de que aparezca en el selector.

# librechat.yaml — project root, beside your .env
version: 1.3.5          # the value the documentation's own example carries

endpoints:
  custom:
    # Required: name, apiKey, baseURL, models. The name must be unique and
    # must not reuse a built-in endpoint name such as openAI or anthropic.
    - name: "Kunavo"
      apiKey: "${KUNAVO_API_KEY}"        # resolved from .env, not written here
      # Keep the /v1. LibreChat appends /chat/completions to this by default.
      baseURL: "https://api.kunavo.com/v1"
      models:
        default: ["claude-sonnet-5", "claude-haiku-4-5"]
        fetch: true                      # fills the picker from GET /v1/models
      titleConvo: true
      titleModel: "claude-haiku-4-5"         # titles are a separate call — pin a cheap id
      modelDisplayLabel: "Kunavo"

      # Optional but worth the four lines: without it LibreChat prices your
      # traffic from a table it ships. prompt/completion are USD per million
      # tokens; context is that model's own window. All three required.
      tokenConfig:
        claude-sonnet-5:
          prompt: 1.4
          completion: 7
          context: 1000000
        claude-haiku-4-5:
          prompt: 0.7
          completion: 3.5
          context: 200000

Paso a paso

1. Cree una clave en /app/keys y cópiela: se muestra una sola vez.
2. En Docker, monta primero la configuración: la guía de inicio rápido indica que copies docker-compose.override.yml.example a docker-compose.override.yml y descomentes el volumen librechat.yaml. En una instalación directa en el equipo, puedes omitir este paso.
3. Crea o edita librechat.yaml en la raíz del proyecto, en el mismo directorio que .env, y añade la entrada endpoints.custom anterior.
4. Incluye la clave en .env como KUNAVO_API_KEY=sk-kn-.... El marcador ${KUNAVO_API_KEY} del YAML se sustituye por ese valor, así el secreto no queda en el archivo de configuración que confirmas en el repositorio.
5. Reinicia LibreChat y abre el selector de endpoints: Kunavo aparecerá como una entrada independiente junto a las integradas. La lista de modelos se obtendrá de GET /v1/models o, si falla la consulta, se usará tu array models.default.
6. Envía un mensaje y luego comprueba que el selector de modelos cambia de modelo. Los ID se resuelven en el endpoint, así que es normal que haya un ID de Claude y otro de GPT bajo una misma entrada; no es un error de configuración.

Comprobado con Referencia del objeto de endpoint personalizado de LibreChat el 21 de septiembre de 2026. La configuración de terceros puede cambiar; si el nombre de un campo ya no coincide con lo que ves, esa página es la autoridad, no esta.

Verifica antes de depurar el cliente

Una solicitud determina si el fallo está en el endpoint, la clave o el archivo de configuración. Si devuelve JSON, la misma URL base y la misma clave funcionan en LibreChat.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Qué ID de modelo introducir en el campo

Todos los modelos de texto están disponibles mediante un ID de modelo; la lista activa está en GET /v1/models, y el catálogo con precios está en la página de modelos. Las tarifas son USD por 1M de tokens, entrada / salida.

Tres campos opcionales con comportamientos distintos detrás de un gateway

Todo lo que aparece en esta tabla procede de la misma referencia de campos, consultada en la fecha indicada arriba. Es la descripción de LibreChat de su propia configuración; no es un resultado de una prueba de Kunavo ni una afirmación sobre el comportamiento de un ID de modelo específico cuando la solicitud sale del cliente.

La guía de cuatro pasos —montar, configurar, establecer la variable de entorno y reiniciar— está en la página de inicio rápido de endpoints personalizados de LibreChat, que usa un gateway en su ejemplo práctico.