# Open WebUI (/es/docs/guides/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](https://console.cheapaimodel.ai/keys) de la consola |
| ID del modelo | Selector de modelos, o **Advanced → Model IDs** | `deepseek-v4-1-flash`, o cualquier ID del [catálogo](/es/models)                          |

## Configuración [#set-it-up]

<Steps>
  <Step>
    ### Agrega la conexión [#add-the-connection]

    1. Con la sesión iniciada como administrador, abre **Settings → Admin → Connections**.
    2. Junto a **Manage OpenAI API Connections**, haz clic en **Add Connection*&#x2A; (el botón &#x2A;*+**).
    3. En **URL**, escribe `https://api.cheapaimodel.ai/v1`.
    4. Deja **Auth** en **Bearer** y pega tu clave de cheapaimodel en **API Key**.
    5. Deja **API Type** en **Chat Completions**.
    6. Haz clic en **Verify Connection** y luego en **Save**.
  </Step>

  <Step>
    ### Elige un modelo [#pick-a-model]

    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.
  </Step>
</Steps>

## Variables de entorno [#environment-variables]

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:

```bash title="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 [#documents-and-knowledge]

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 [#common-mistakes]

* **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](/es/models). 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**.