Open WebUI
Instale Open WebUI, agregue RunAPI como una conexión compatible con OpenAI, seleccione un modelo y verifique un chat.
Conecte Open WebUI a RunAPI a través de su Conexión compatible con OpenAI. Necesita acceso de administrador a Open WebUI y una Clave de API estándar de RunAPI de la Guía de Autenticación.
Instalar Open WebUI
Siga la guía de inicio rápido oficial de Open WebUI para su plataforma. Para una instalación local con Docker, puede iniciar la imagen oficial con:
docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main
Abra la aplicación, cree la cuenta de administrador e inicie sesión antes de agregar la conexión.
Agregar la conexión de RunAPI
- Abre Admin Settings → Connections → OpenAI y selecciona Add Connection.
- Establece la URL en
https://runapi.ai/v1e ingresa tu Clave de API de RunAPI. - Deja Model IDs (Filter) vacío en el primer intento de conexión para que Open WebUI pueda detectar los modelos disponibles.
- Guarda la conexión y espera a que la verificación finalice.
Open WebUI envía la verificación de conexión desde su backend y usa GET
/v1/models para el descubrimiento. La URL de RunAPI es HTTPS pública, por lo que una
instalación de Docker no necesita host.docker.internal para esta conexión.
Seleccionar un modelo
Abra un nuevo chat y seleccione un modelo de RunAPI desde el selector de modelos del chat. Use el Catálogo de modelos para confirmar el identificador de modelo actual y las capacidades.
Si el descubrimiento no rellena el selector, edite la conexión y agregue el identificador exacto en Model IDs (Filter). Un error de descubrimiento de modelo y un error de Chat Completions son señales separadas; pruebe el modelo agregado manualmente antes de eliminar la conexión.
Verificar la conexión
Envíe un mensaje breve como Reply with the word connected. Una respuesta en streaming o completa normal confirma que Open WebUI puede usar el modelo de RunAPI seleccionado.
Solución de problemas
- La verificación devuelve
401o403: reemplaza la clave de API en la conexión por una clave estándar válida de la Guía de autenticación. - No aparece ningún modelo de RunAPI: confirma que la URL termina en
/v1, luego agrega un identificador actual en Model IDs (Filter) y vuelve a intentar el chat. - El modelo es visible pero el chat falla: confirma que el identificador admite Chat Completions compatible con OpenAI en el Catálogo de modelos y luego inspecciona los registros del backend de Open WebUI para ver el estado de la solicitud.
- Una URL local funciona en el navegador pero no en Open WebUI: las conexiones de Open WebUI se originan desde su backend. Esto no afecta a la URL pública
https://runapi.ai/v1, pero sí importa para otras conexiones locales.
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.