Open WebUI

Chatea con los modelos de cheapaimodel en Open WebUI mediante una conexión de OpenAI API.

Open WebUI se conecta a servicios compatibles con OpenAI mediante conexiones OpenAI API, que un administrador agrega en Settings → Admin → Connections. Una vez guardada la conexión, sus modelos aparecen en el selector de modelos de todos los usuarios.

	Configuración de Open WebUI	Valor
Base URL	URL	`https://api.cheapaimodel.ai/v1`
Clave de API	API Key (con Auth en Bearer)	Tu clave de la página Claves de API de la consola
ID del modelo	Selector de modelos, o Advanced → Model IDs	`deepseek-v4-1-flash`, o cualquier ID del catálogo

Configuración

Agrega la conexión

Con la sesión iniciada como administrador, abre Settings → Admin → Connections.
Junto a Manage OpenAI API Connections, haz clic en Add Connection (el botón +).
En URL, escribe https://api.cheapaimodel.ai/v1.
Deja Auth en Bearer y pega tu clave de cheapaimodel en API Key.
Deja API Type en Chat Completions.
Haz clic en Verify Connection y luego en Save.

Elige un modelo

Open WebUI lee la lista de modelos de /v1/models, que devuelve los modelos que tu clave puede usar. Elige deepseek-v4-1-flash en el selector de modelos y empieza un chat.

Para ofrecer solo algunos modelos, agrega sus IDs en Advanced → Model IDs; a partir de ahí, Open WebUI muestra exactamente esos y deja de consultar la lista. Si otra conexión ofrece los mismos IDs, define un Prefix ID, como cheapaimodel: el modelo aparece como cheapaimodel.deepseek-v4-1-flash, y Open WebUI quita el prefijo antes de enviar la solicitud.

Variables de entorno

En una instalación nueva también puedes crear la misma conexión al arrancar. Agrega las dos variables al comando o al archivo de Compose con el que inicias Open WebUI:

Terminal

docker run -d -p 3000:8080 \
  -v open-webui:/app/backend/data \
  -e OPENAI_API_BASE_URL="https://api.cheapaimodel.ai/v1" \
  -e OPENAI_API_KEY="$CHEAPAIMODEL_API_KEY" \
  --name open-webui --restart always \
  ghcr.io/open-webui/open-webui:main

Open WebUI solo lee estas variables la primera vez que se inicia y después guarda los valores en su base de datos. Para cambiar la conexión más adelante, ve a Settings → Admin → Connections.

Documentos y conocimiento

cheapaimodel todavía no tiene modelos de embeddings. En Settings → Admin → Documents, deja el motor de embeddings en el modelo integrado de Open WebUI o en otro proveedor; no lo apuntes a cheapaimodel. La imagen :slim no trae un modelo de embeddings integrado, así que para usar RAG con ella necesitas los embeddings de otro proveedor.

Errores comunes

Verify Connection falla con 404 y fault filter abort, y no aparece ningún modelo. A URL le falta /v1. Usa https://api.cheapaimodel.ai/v1.
Todos los mensajes fallan con 404 y el mensaje Invalid URL (POST /v1/chat/completions/chat/completions). URL incluye la ruta del endpoint. Open WebUI agrega la ruta por su cuenta; usa https://api.cheapaimodel.ai/v1.
401. La clave es incorrecta, ya venció o se quedó sin presupuesto, o Auth no está en Bearer. Revisa la clave en la consola.
503 con model_not_found. Un ID que escribiste en Model IDs no coincide con el catálogo. Corrige cómo está escrito, o vacía la lista para que se consulte en /v1/models.
Los cambios en las variables de entorno no tienen efecto. Solo se aplican la primera vez que se inicia Open WebUI. Edita la conexión en Settings → Admin → Connections.