LobeChat (LobeHub) con Claude y GPT mediante una API propia

Sí. LobeChat ahora se llama LobeHub: el repositorio de GitHub lobehub/lobe-chat redirige a lobehub/lobehub, la documentación usa el nombre nuevo y la imagen de Docker es lobehub/lobehub. Es una aplicación de código abierto para chat y agentes que puedes usar en la web, como aplicación de escritorio o autoalojada. Cada agente elige un proveedor y un modelo, así que puedes usar Claude para una tarea y GPT para otra.

Esta guía sigue la documentación de LobeHub y las etiquetas de la interfaz de octubre de 2026.

LobeHub ofrece tres formas de apuntar a APIVAI:

La regla de /v1: las URL en formato OpenAI terminan en /v1; la de Anthropic no, porque el SDK de Anthropic añade /v1/messages por su cuenta. LobeHub además elimina un /v1 final en las URL de Anthropic, pero el valor limpio es https://api.apivai.com. Más sobre ambos formatos: API compatible con OpenAI y proxy de la API de Claude.

1. Crea una cuenta con tu correo.
2. Recarga desde $10 con tarjeta, criptomonedas, Alipay o WeChat Pay. Pagas por token, sin suscripción.
3. Crea una clave en el Panel y cópiala. Ponle un límite de presupuesto si la van a usar varias personas.

1. Abre App Settings → AI Providers.
2. Haz clic en Add Custom Provider. Se abre el diálogo Create Custom AI Provider.
3. Rellena los campos de la tabla y haz clic en Create.
4. En la página del nuevo proveedor, usa Connectivity Check: elige un modelo y haz clic en Check. Deberías ver Check passed.
5. En la lista de modelos, haz clic en Fetch models para cargar los IDs de /v1/models y activa los que quieras. También puedes hacer clic en Add Model y escribir un Model ID a mano.
6. Abre la configuración de tu agente y selecciona el proveedor APIVAI y un modelo.

Use Client Request Mode envía las peticiones directamente desde el navegador en lugar de pasar por el servidor de LobeHub. Déjalo desactivado salvo que tengas un motivo; si lo activas y ves errores de red, vuelve a desactivarlo.

Selecciona Anthropic en AI Providers, actívalo, pega tu clave de APIVAI en API Key y escribe https://api.apivai.com en API Proxy URL. Ejecuta Check y activa los modelos Claude. El ID del modelo debe coincidir con un ID de APIVAI como claude-sonnet-4-6; si una tarjeta de modelo integrada usa otro ID, añade el correcto con Add Model. Si Fetch models no devuelve nada en este modo, añade los IDs a mano. Un proveedor propio con Request Format en Anthropic y la misma URL funciona igual.

Selecciona OpenAI, pega tu clave y pon https://api.apivai.com/v1 en API Proxy URL. Deja Use Responses API Specification desactivado: LobeHub indica que solo lo admiten los modelos de OpenAI, y por este proveedor también enviarás peticiones a Claude.

Un servidor LobeHub autoalojado lee la configuración de proveedores desde variables de entorno. Añádelas al archivo lobehub.env de la guía de Docker, junto a las variables de base de datos y autenticación que ya necesita:

Después inicia el contenedor como siempre, por ejemplo docker run -d -p 3210:3210 --env-file lobehub.env --name lobehub lobehub/lobehub, y reinícialo tras cada cambio en el archivo.

OPENAI_MODEL_LIST usa la sintaxis de lista de modelos de LobeHub: -all oculta los modelos OpenAI predeterminados, +id añade un modelo e id=Display Name le cambia el nombre. Una clave definida así es una clave de servidor que comparten todos los usuarios de tu instancia, así que dale su propio presupuesto en el Panel de APIVAI. La documentación de LobeHub señala que una respuesta vacía suele deberse a que falta /v1 en OPENAI_PROXY_URL; con APIVAI, inclúyelo siempre.

El chat funciona por completo a través de APIVAI. Los archivos y la base de conocimiento necesitan además un modelo de embeddings para indexar documentos, y APIVAI no ofrece embeddings.

Por defecto, LobeHub crea los embeddings con text-embedding-3-small de OpenAI a través del proveedor OpenAI. Si apuntaste OPENAI_PROXY_URL a APIVAI, la indexación de archivos fallará, y esa es otra razón para usar un proveedor propio para el chat. Configura un proveedor de embeddings aparte con DEFAULT_FILES_CONFIG, por ejemplo DEFAULT_FILES_CONFIG=embedding_model=ollama/<tu-modelo-de-embeddings>; la guía de base de conocimiento de LobeHub enumera los proveedores admitidos. Las respuestas sobre tus archivos siguen viniendo de tu modelo de chat en APIVAI.

Precios por millón de tokens a fecha de 2026-10-07. La lista cambia con el tiempo, así que toma los IDs de GET https://api.apivai.com/v1/models (o de Fetch models) y de la página de precios.

Una configuración práctica: Claude Haiku 4.5 o GPT-6 Luna para un agente asistente general, Claude Sonnet 4.6 para agentes de redacción y programación, y Claude Opus 5.5 solo para el agente que se ocupa del trabajo más difícil.

APIVAI cobra por token desde un saldo prepago. Cada mensaje reenvía el historial de la conversación, así que en los chats largos cada mensaje cuesta más.

Ejemplo 1: uso personal diario. 50 mensajes al día durante 30 días, cada uno de unos 3.000 tokens de entrada y 800 de salida: 1.500 mensajes cuestan $10.94 con Claude Sonnet 4.6 ($31.50 a precios oficiales), o $0.157 con GPT-6 Luna.

Ejemplo 2: trabajo con muchos documentos. Un agente que lee textos largos, 10 peticiones por día laborable durante 22 días, cada una de unos 20.000 tokens de entrada y 1.500 de salida: 220 peticiones cuestan $4.18 con Claude Sonnet 5.5, frente a $12.10 a precios oficiales.

El Panel muestra los tokens y el coste de cada petición. La comparación de precios de la API de Claude muestra todos los modelos junto a los precios oficiales.

• 401 o "API key invalid": revisa que la clave no tenga espacios de más, que no se haya eliminado, y comprueba su presupuesto y tu saldo en el Panel.
• 404: la URL tiene mal el /v1. El formato OpenAI (proveedor propio, proveedor OpenAI, OPENAI_PROXY_URL) necesita https://api.apivai.com/v1; el formato Anthropic necesita https://api.apivai.com. Nunca añadas /chat/completions ni /messages.
• Modelo no encontrado: el Model ID debe coincidir exactamente con un ID de APIVAI, por ejemplo claude-sonnet-4-6, no con un nombre visible. Usa Fetch models o GET /v1/models.
• Respuestas vacías o cortadas: el razonamiento está activado por defecto y sus tokens cuentan como salida. En la configuración de modelo del agente, activa Enable Max Tokens Limit y fija Max Tokens Limit en 4096 o más. Si las respuestas llegan vacías en formato OpenAI, confirma también que la URL termina en /v1.
• Las variables de entorno no tienen efecto: reinicia el contenedor después de editar lobehub.env y revisa que los nombres de las variables sean exactamente los de arriba.
• 429: el límite por defecto es de 60 peticiones por minuto por clave. Si una instancia compartida lo alcanza, pide a soporte que lo suba.

Sí. LobeChat pasó a llamarse LobeHub; el repositorio, la documentación y la imagen de Docker usan ahora el nombre LobeHub. Los ajustes que las guías antiguas describen para LobeChat están en App Settings → AI Providers.

Sí, con un proveedor propio en formato OpenAI en https://api.apivai.com/v1. Una clave de APIVAI funciona con todos los modelos de la página de precios.

No. Docker solo hace falta para ejecutar tu propio servidor LobeHub. En cualquier aplicación de LobeHub que muestre AI Providers, puedes añadir APIVAI desde la configuración como se describe arriba.

APIVAI no registra el contenido de las peticiones ni de las respuestas. Tu historial lo guarda LobeHub, en tu propio servidor si lo autoalojas.

No. APIVAI es prepago y de pago por uso, desde $10 y sin suscripción. Consulta la documentación para otras herramientas o la guía de Open WebUI para otra interfaz de chat autoalojada.

Crea una cuenta, recarga desde $10 y pega tu clave en LobeHub.