Ejecuta LobeChat sobre un endpoint personalizado compatible con OpenAI.

Updated 2026-07-29

El módulo de proveedores de LobeChat acepta cualquier servicio compatible con OpenAI: crea un proveedor personalizado con el tipo de SDK OpenAI, configura el endpoint en https://api.apisrouter.com/v1, pega una clave y obtén la lista de modelos. Los ids de Claude, GPT, Gemini y DeepSeek aparecen en el selector de modelos de cada asistente.

Respuesta rápida: un proveedor personalizado, un endpoint, una clave.

Abre los ajustes de LobeChat y ve a la sección de proveedor de servicio de IA (etiquetada como AI Service Provider o Language Model según la versión). Desde que el módulo de gestión de proveedores llegó en la v1.44, puedes crear un proveedor personalizado en lugar de aprovechar la entrada integrada de OpenAI: añade un proveedor, dale un id y un nombre visible (apisrouter / APIsRouter), elige el tipo de SDK OpenAI, y luego rellena la API key y la URL de proxy del endpoint con https://api.apisrouter.com/v1. En la lista de modelos del proveedor, usa la acción de obtener modelos (fetch) para traer cada id que sirve el endpoint a través de /v1/models, activa los que quieras y ejecuta la comprobación de conectividad integrada. A partir de ahí, cualquier asistente o conversación puede seleccionar esos ids desde el selector de modelos. El proyecto ahora vive en lobehub/lobehub en GitHub (el nombre del repo lobe-chat redirige ahí), y las etiquetas de los menús cambian entre versiones, así que trata el flujo, entrada de proveedor, tipo de SDK, URL, clave, fetch, como la parte estable en lugar de la redacción exacta.

Provider ID:    apisrouter
Provider Name:  APIsRouter
SDK Type:       OpenAI
API Key:        sk-YOUR-APISROUTER-KEY
API Proxy URL:  https://api.apisrouter.com/v1

Model List → Fetch models → enable ids → check

Cómo enruta LobeChat las peticiones a un proveedor.

LobeChat (con unas 80K estrellas en GitHub, ahora bajo el nombre LobeHub) es uno de los frameworks de chat de código abierto más desplegados: un cliente web pulido, asistentes con sus propios prompts y modelos, un sistema de plugins y funciones de base de conocimiento, desplegable en una sesión de navegador o autoalojado con una base de datos. Cada entrada de proveedor describe hacia dónde van las peticiones y qué dialecto de SDK hablar. Un proveedor personalizado con el tipo de SDK OpenAI envía peticiones estándar de chat completions a tu URL de proxy con el id del modelo como una cadena simple, exactamente la forma que espera un gateway multiproveedor. Por eso una sola entrada lleva todo el catálogo: los asistentes pueden fijar claude-sonnet-4-6 para trabajo cuidadoso mientras las conversaciones rápidas corren en gemini-3.5-flash, sin una segunda cuenta en ningún sitio. La URL del endpoint tiene un matiz documentado que vale la pena citar: si la URL necesita el sufijo /v1 depende del servicio que haya detrás. LobeChat añade rutas como /chat/completions a la base que le des, así que para APIsRouter el valor correcto es https://api.apisrouter.com/v1. El síntoma documentado de un sufijo ausente es que el modelo devuelva una respuesta vacía en la prueba; si ves eso, añade /v1 y vuelve a intentarlo.

Autoalojamiento: la vía de las variables de entorno.

Si despliegas LobeChat tú mismo, el mismo enrutamiento puede venir integrado en el contenedor en lugar de configurarse a golpe de clic en la interfaz. El par clásico sobrescribe el proveedor OpenAI integrado: OPENAI_API_KEY toma la clave del gateway y OPENAI_PROXY_URL toma https://api.apisrouter.com/v1. Cada usuario de ese despliegue hereda entonces el endpoint sin tocar los ajustes. La visibilidad de los modelos se controla con la sintaxis de la lista de modelos: OPENAI_MODEL_LIST acepta +id para añadir, -id para ocultar, e id=Nombre visible para renombrar, con las entradas separadas por comas. Empezar el valor con -all limpia la lista integrada para que solo se muestren tus ids explícitos, la forma más limpia para un despliegue curado. Las compilaciones de servidor más recientes también documentan una familia CUSTOM_PROVIDER_* (count, id, name, type, base URL, keys) para declarar proveedores personalizados completos en el momento del despliegue, igualando lo que hace el módulo de la interfaz. Revisa la referencia actual de variables de entorno para tu versión antes de depender de ella, ya que esta superficie es más nueva que el par OPENAI_* y sigue evolucionando.

OPENAI_API_KEY=sk-YOUR-APISROUTER-KEY
OPENAI_PROXY_URL=https://api.apisrouter.com/v1
OPENAI_MODEL_LIST=-all,+claude-sonnet-4-6=Claude Sonnet 4.6,+gpt-5.5,+gemini-3.5-flash,+deepseek-v4-pro

Elegir modelos para los asistentes.

Como todos los asistentes facturan a través de una sola clave, comparar modelos es solo un cambio en los ajustes del asistente. Fija dos candidatos en dos asistentes duplicados, ejecuta tus prompts reales durante una semana, y lee el gasto por modelo en la consola de APIsRouter junto a la calidad de respuesta que observaste.

  • Los asistentes son fijaciones de modelo por rol. Un asistente de escritura con claude-sonnet-4-6, un asistente de respuestas rápidas con claude-haiku-4-5-20251001 y un asistente de investigación con gpt-5.5 coexisten detrás de una sola entrada de proveedor.
  • gemini-3.5-flash es la opción de capacidad de respuesta para el modelo de conversación por defecto; la mayoría de los turnos en un framework de chat son cortos, y los modelos rápidos mantienen la interfaz con sensación instantánea.
  • deepseek-v4-pro se gana un puesto para conversaciones multilingües largas y resúmenes intensivos, donde su comportamiento de contexto largo por token gastado es el atractivo.
  • Las conversaciones con visión necesitan un id capaz de visión con la capacidad activada en la configuración del modelo del proveedor; LobeChat expone interruptores de capacidad por modelo en el módulo de proveedores.
  • Activa deliberadamente un selector de dos niveles, un id rápido y un id de vanguardia, y añade más solo cuando un asistente real los necesite; cada modelo activado es una fila que los usuarios tienen que desplazar.

Pago por uso · por debajo del precio oficial

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

ModeloPrecio oficialNuestro precio
Claude Sonnet 4.6$3.00 / $15.00 per M$2.40 / $12.00 per M
GPT-5.5$5.00 / $30.00 per M$4.00 / $24.00 per M
Gemini 3.5 Flash$1.50 / $9.00 per M$1.20 / $7.20 per M
DeepSeek V4 Pro$0.43 / $0.87 per M$0.40 / $0.90 per M
Claude Haiku 4.5 20251001$1.00 / $5.00 per M$0.80 / $4.00 per M

Modos de fallo específicos de LobeChat.

Una respuesta vacía en la comprobación de conectividad es la señal documentada de un problema con el sufijo del base URL. Añade o quita el /v1 (para APIsRouter debe estar presente) y vuelve a intentarlo antes de depurar nada más profundo. Que falten modelos en el selector de un asistente suele significar que se obtuvieron con fetch pero no se activaron en la lista de modelos del proveedor, o que el propio interruptor del proveedor está apagado. Ambos viven en la misma pantalla de ajustes que la acción de fetch. En despliegues autoalojados, recuerda la precedencia: las variables de entorno configuran los valores por defecto del lado del servidor, mientras que los usuarios aún pueden introducir sus propios ajustes de proveedor del lado del cliente, según la autenticación y los feature flags de tu despliegue. Si un despliegue ignora tu OPENAI_PROXY_URL, confirma que el contenedor realmente se reinició con el nuevo entorno y que la sesión del cliente no lo está sobrescribiendo localmente. Aquí la deriva de versiones es real: el árbol de ajustes se ha reorganizado más de una vez (Language Model, luego AI Service Provider, con el módulo de proveedores llegando en la v1.44), y las capturas de pantalla de tutoriales antiguos no coincidirán con los menús actuales. Los campos en sí, id, name, tipo de SDK, URL, clave, se han mantenido estables.

Quién enruta LobeChat a través de un gateway.

  • Quienes autoalojan LobeChat para un equipo y quieren un solo endpoint en el contenedor y un único registro de uso para todos, en lugar de claves de proveedor por usuario.
  • Usuarios avanzados de asistentes que fijan distintos proveedores por rol, Claude para escritura, GPT para análisis, DeepSeek para volumen, sin mantener cuentas para cada uno.
  • Usuarios que quieren modelos que la lista de proveedores integrada no trae, activados al obtener el catálogo del gateway en vez de esperar a las versiones aguas arriba.
  • Desarrolladores sin acceso a la facturación de un proveedor concreto. El acceso basado en recargas sin requisito de tarjeta elimina la dependencia de registrarse en cada proveedor.
  • Personas que ya enrutan su editor, lanzador o herramientas de CLI a través de un gateway y quieren su framework de chat con la misma clave.

Verifica el endpoint y depura la primera conversación.

Primero haz curl al listado de modelos y deja la salida abierta; es la grafía autorizada para cada id que actives, ya sea por fetch o a mano. Luego ejecuta una chat completion contra el id que planeas dejar por defecto. Dentro de LobeChat, ejecuta la comprobación de conectividad antes de conversaciones reales. Los fallos de autenticación apuntan al campo de la clave. Una respuesta vacía apunta al sufijo /v1. Los errores de no encontrado en un modelo específico significan que el id activado no coincide con el listado, lo que suele pasar después de editar a mano nombres visibles e ids juntos. Una vez que fluyen las conversaciones, la consola de APIsRouter muestra el modelo, el recuento de tokens y el gasto por petición. Un framework de chat con asistentes genera tráfico entre varios modelos a la vez, y la vista de uso por clave es donde el hábito de cada asistente se convierte en un coste que puedes ver por modelo, por día.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-3.5-flash",
       "messages":[{"role":"user","content":"ping"}]}'

Preguntas frecuentes

¿Cómo añado un proveedor personalizado compatible con OpenAI a LobeChat?

En los ajustes, abre la sección de proveedor de servicio de IA y crea un proveedor personalizado: id y nombre visible, tipo de SDK OpenAI, endpoint https://api.apisrouter.com/v1 y tu clave. Obtén la lista de modelos con fetch, activa los ids que quieras y ejecuta la comprobación de conectividad.

¿La URL del endpoint necesita /v1?

Para APIsRouter, sí: https://api.apisrouter.com/v1. LobeChat añade rutas como /chat/completions a la base que le des, y su documentación indica que un sufijo incorrecto suele mostrarse como una respuesta vacía en la prueba. Si ves eso, corrige el sufijo y vuelve a intentarlo.

¿Qué es OPENAI_PROXY_URL y cuándo lo uso?

Es la variable de entorno de autoalojamiento que redirige el proveedor OpenAI integrado de LobeChat a otra base URL. Configúrala junto con OPENAI_API_KEY en el contenedor y cada usuario de ese despliegue hereda el endpoint; usa OPENAI_MODEL_LIST para elegir qué ids se muestran.

¿Pueden distintos asistentes usar distintos proveedores a través de un solo proveedor?

Sí. Cada asistente fija su propio modelo, y el id viaja al endpoint como una cadena simple en cada petición. Una sola entrada de proveedor puede servir a un asistente de Claude, uno de GPT y uno de DeepSeek en paralelo, todos facturados con la misma clave.

¿LobeChat es el mismo proyecto que LobeHub?

Sí. El proyecto cambió de marca y el repositorio de GitHub ahora vive en lobehub/lobehub, con el antiguo nombre lobe-chat redirigiendo hacia allí. La documentación y los menús mezclan ambos nombres durante la transición, lo cual también explica por qué las etiquetas de ajustes varían entre versiones.

¿Por qué los modelos que obtuve con fetch no aparecen en las conversaciones?

El fetch lista los ids; activarlos es un interruptor aparte por modelo en la lista de modelos del proveedor, y el propio proveedor tiene un interruptor de activación. Revisa ambos y vuelve a abrir el selector de modelos. Si un id activado sigue dando error, compara su grafía con la salida de /v1/models.