Documentación

Open WebUI

Open WebUI trata cualquier endpoint compatible con OpenAI como una conexión. Añada una desde Admin Settings o defina dos variables de entorno al iniciar el contenedor: ambas opciones llevan al mismo resultado.

Una conexión OpenAI en Admin Settings, o OPENAI_API_BASE_URL y OPENAI_API_KEY al iniciar el contenedor — ambas terminan en el mismo /v1.

Conexión o docker run

# Settings → Admin Settings → Connections → Manage OpenAI API Connections → +
URL                https://api.kunavo.com/v1
API Key            sk-kn-...
Model IDs (Filter) claude-sonnet-5, claude-opus-5, claude-haiku-4-5, gpt-5-6-terra

# …or at container start, same thing:
docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://api.kunavo.com/v1 \
  -e OPENAI_API_KEY=sk-kn-... \
  -v open-webui:/app/backend/data \
  --name open-webui ghcr.io/open-webui/open-webui:main

Rellene Model IDs (Filter). Si no lo hace, el selector muestra todo el catálogo, incluidos modelos de imagen, vídeo y música que no se pueden usar desde una ventana de chat, y el primer clic del usuario abre uno de ellos. Este filtro también sirve cuando un endpoint no dispone de una ruta /models; Kunavo sí la tiene, así que la verificación se completa en cualquier caso.

La URL conserva /v1. Si Open WebUI se ejecuta en Docker y apunta a algo en el mismo host, sustituya localhost por host.docker.internal. Esto no se aplica a un endpoint alojado, pero es el siguiente error que suele producirse.

¿Aún no tienes una clave? Crea una cuenta de Kunavo, genera una clave (empieza por sk-kn-) y añade crédito desde $10; las llamadas se pagan con ese saldo y las llamadas fallidas no se facturan. El panel se abre entonces en la configuración de Open WebUI.

Paso a paso

Cree una clave en /app/keys y cópiela: se muestra una sola vez.
En Open WebUI, vaya a Settings → Admin → Connections y busque Manage OpenAI API Connections.
Haga clic en ➕ Add Connection e introduzca la URL y la clave API.
Añada los identificadores que quiera a Model IDs (Filter), guarde los cambios y deje que se verifique la conexión.
Inicie un chat nuevo: los modelos aparecerán en el selector con el nombre de la conexión como prefijo.

Comprobado con Guía de Open WebUI para proveedores compatibles con OpenAI el 6 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 Open WebUI.

# 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.

ID de modelo	Entrada / salida de Kunavo	Dónde encaja en Open WebUI
`claude-sonnet-5`	$1.40 / $7.00	la opción general predeterminada para chat
`claude-opus-5`	$3.50 / $17.50	hilos de análisis extensos
`claude-haiku-4-5`	$0.70 / $3.50	rápido, barato y adecuado para la mayoría de los turnos
`gpt-5-6-terra`	$0.70 / $4.20	documentos largos pegados en la ventana de chat

La facturación es por token desde un saldo prepago, sin cuota mensual; consulta facturación. Con contexto repetido —que constituye la mayor parte de lo que envía un editor o cliente de chat—, la caché de indicaciones cambia más la factura que la elección del modelo.

Preguntas frecuentes

¿Cómo conecto Open WebUI a una API compatible con OpenAI?

Vaya a Settings → Admin → Connections, abra «Manage OpenAI API Connections» y haga clic en Add Connection. Después, introduzca la URL del endpoint —la raíz /v1— y la clave API. También puede configurar las variables de entorno OPENAI_API_BASE_URL y OPENAI_API_KEY al iniciar el contenedor. Ambas opciones crean la misma conexión.

¿Para qué sirve Model IDs (Filter) en Open WebUI?

Restringe los identificadores de modelo de esa conexión que aparecen en el selector y también sirve como alternativa para endpoints que no implementan una ruta /models: en ese caso, se añaden los identificadores manualmente y la verificación falla, aunque el chat siga funcionando. En una pasarela con un catálogo multimodal amplio, conviene definirlo de todos modos para que el selector de chat solo muestre modelos que se puedan usar desde una ventana de chat.

¿La URL base de Open WebUI incluye /v1?

Sí. Open WebUI solo añade la ruta a la URL que se le proporciona, así que la URL de conexión es la raíz /v1: https://api.example.com/v1. Los endpoints de los propios ejemplos de la documentación incluyen ese sufijo. Sin él, la conexión se guarda, pero todas las solicitudes devuelven un error 404.

¿Puede Open WebUI usar modelos Claude y GPT?

Sí, si se ofrecen a través de un endpoint compatible con OpenAI. Open WebUI envía el identificador del modelo directamente a la URL de conexión, así que los identificadores de cualquier proveedor se resuelven en el endpoint, no en Open WebUI. Eso también permite que Claude y GPT aparezcan en el mismo selector de modelos con una sola conexión y una sola clave.