Documentación

LobeChat

Una instalación autohospedada de LobeChat necesita tres variables de entorno para conectarse a Kunavo: una clave, una URL de proxy y la lista de ID de modelo que quieres mostrar en el selector.

Asigna OPENAI_API_KEY a tu clave de sk-kn-…, OPENAI_PROXY_URL a https://api.kunavo.com/v1 e indica los ID que quieras en OPENAI_MODEL_LIST. Claude y GPT compartirán así un mismo selector y saldo.

.env

OPENAI_API_KEY=sk-kn-...
OPENAI_PROXY_URL=https://api.kunavo.com/v1

# LobeChat only shows models it knows about, so name the ones you want.
OPENAI_MODEL_LIST=claude-sonnet-5,claude-haiku-4-5,claude-opus-5,gpt-5-6-terra

El sufijo /v1 debe incluirse en OPENAI_PROXY_URL. LobeChat reenvía las solicitudes a la URL que le proporcionas, en lugar de reconstruir la ruta de OpenAI. Por eso, en su propia .env.example se indica el valor predeterminado como https://api.openai.com/v1, con el sufijo incluido.

Paso a paso

Cree una clave en /app/keys y cópiela: se muestra una sola vez.
Añade las tres variables al entorno de tu despliegue: al archivo .env en una instalación independiente o al bloque environment en Docker.
Reinicia el contenedor para que lea el nuevo entorno.
Abre LobeChat, inicia una sesión y elige uno de los ID que incluiste en OPENAI_MODEL_LIST.

docker-compose.yml

services:
  lobe-chat:
    image: lobehub/lobe-chat
    ports:
      - "3210:3210"
    environment:
      OPENAI_API_KEY: sk-kn-...
      OPENAI_PROXY_URL: https://api.kunavo.com/v1
      OPENAI_MODEL_LIST: claude-sonnet-5,claude-haiku-4-5,gpt-5-6-terra

La referencia de LobeChat para estas variables está en la página de variables de entorno del proveedor de modelos.

Verifica antes de depurar el contenedor

Una solicitud basta para determinar si el problema está en el endpoint, la clave o la lista de modelos de LobeChat. Si devuelve una lista JSON de ID de modelo, esa misma URL y clave funcionan; si después el selector aparece vacío, el problema está en OPENAI_MODEL_LIST, no en el endpoint.

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

Qué ID incluir

Puedes incluir en OPENAI_MODEL_LIST cualquier modelo de texto de Kunavo. La lista completa está en la página de modelos y se obtiene en tiempo real de GET /v1/models. Las tarifas están en USD por 1M de tokens, entrada / salida.

ID de modelo	Entrada / salida de Kunavo	Uso recomendado
`claude-haiku-4-5`	$0.70 / $3.50	El Claude más barato: para sesiones de chat largas en las que importa el coste por turno
`claude-sonnet-5`	$1.40 / $7.00	El equilibrio predeterminado entre calidad y precio
`claude-opus-5`	$3.50 / $17.50	El nivel de Claude de mayor calidad
`gpt-5-6-terra`	$0.70 / $4.20	La misma clave, otra familia: no hace falta configurar un segundo proveedor

En cada turno, un cliente de chat vuelve a enviar toda la conversación, así que el gasto en tokens de LobeChat crece con la duración de la sesión, en lugar de mantenerse estable por mensaje. En este caso, el almacenamiento en caché de prompts es el factor más importante. La facturación se realiza por token con un saldo prepagado y sin cuota mensual, así que un mes sin uso no cuesta nada. Consulta los detalles en facturación.

Preguntas frecuentes

¿Cómo configuro LobeChat para usar un endpoint personalizado compatible con OpenAI?

Configura OPENAI_PROXY_URL con la URL base del endpoint y OPENAI_API_KEY con tu clave en el entorno del despliegue. Para Kunavo, la URL es https://api.kunavo.com/v1. El archivo .env.example de LobeChat usa https://api.openai.com/v1 como valor de ejemplo para esa variable, lo que recuerda que el sufijo /v1 debe incluirse en el valor y no añadirse por separado.

¿Por qué mi modelo personalizado no aparece en la lista de modelos de LobeChat?

LobeChat muestra los modelos que se le han indicado, no todos los que el endpoint puede servir. Por eso, un ID de modelo que no figure en su lista no se ve, aunque el endpoint responda a él. Indica los ID en OPENAI_MODEL_LIST como una lista separada por comas. La documentación de LobeChat también define una sintaxis de prefijos para esa variable: un + inicial añade un modelo, un - inicial lo oculta y model_name=display_name cambia el nombre que aparece en el selector.

¿Puede LobeChat usar modelos Claude a través del proveedor OpenAI?

Sí, cuando se sirven a través de un endpoint compatible con OpenAI. El proveedor OpenAI de LobeChat envía el ID del modelo a la URL indicada en OPENAI_PROXY_URL, así que un ID de Claude se resuelve en la pasarela, no dentro de LobeChat, y no se necesitan credenciales de Anthropic. En Kunavo, los ID de Claude y GPT usan una misma clave, así que para añadir una familia basta con agregar un ID a OPENAI_MODEL_LIST.

¿Funciona la generación de imágenes de LobeChat a través de un endpoint personalizado?

Depende de las rutas que implemente el endpoint, no de LobeChat. El proveedor de chat necesita /v1/chat/completions; la generación de imágenes usa una ruta aparte. Kunavo implementa la generación de imágenes y vídeos en sus propios endpoints, documentados en las secciones de imágenes y vídeo. Por eso, la opción fiable es usar LobeChat para el chat y llamar directamente a los endpoints multimedia, en lugar de suponer que una sola configuración del proveedor cubre ambas funciones.