Configuración de la clave de API de Open WebUI

Clave de API de Open WebUI: configura tu propia clave en Conexiones

Rellena estos campos en Conexiones, en el panel de administración, con tu propia clave de API y Open WebUI podrá usar modelos Claude. Pago por uso.

Panel de administración → Configuración → ConexionesUI
config
Admin Panel → Settings → Connections → OpenAI API → +
URL: https://api.aicodewith.ai/v1
API Key: sk-***
Save → new chat → model selector → claude-haiku-4-5-20251001

Pasos de configuración

Guarda esta clave para terminales posteriores

Esta herramienta almacena la clave en su propia configuración. Después de iniciar sesión, copia la clave y pégala en el campo Clave de API de los pasos a continuación.

Clave de API
sk-***

Los visitantes que no han iniciado sesión solo ven un marcador de posición. Inicia sesión y completaremos tu clave. Sign in · Obtén una clave en la consola

Copiar solo pone el comando en el portapapeles. Aún necesitas ejecutarlo en una terminal o pegar la clave en la configuración de la herramienta. Cómo obtener una clave API

Estos pasos se probaron en Linux (Open WebUI v0.12.0). macOS y Windows aún no se han probado, por lo que no se incluyen.

  1. ¿Aún no tienes Open WebUI? Instálalo (omite esto si ya está instalado)

    Ejecuta uv tool install open-webui, luego uv tool list | grep open-webui. Si aparece open-webui con una versión, está instalado. Después ejecuta open-webui serve y abre la dirección que se muestra en la terminal.

    Ejecuta uv tool list | grep open-webui para confirmar que Open WebUI v0.12.0 está instalado (versión enmarcada en rojo)
  2. Haz clic en tu avatar y abre Admin Panel

    En la página de inicio de Open WebUI, haz clic en tu avatar en la esquina inferior izquierda, luego haz clic en Admin Panel en el menú.

    Abre la página de inicio de Open WebUI y haz clic en tu avatar en la esquina inferior izquierda; la entrada Admin Panel en el menú está enmarcada en rojo
  3. Haz clic en Settings en la parte superior

    En la página de Admin Panel, haz clic en la pestaña Settings en la parte superior.

    En la página de Admin Panel, haz clic en la pestaña Settings en la parte superior (enmarcada en rojo)
  4. Haz clic en Connections a la izquierda

    Haz clic en Connections, dentro de AI, en la barra lateral izquierda. Deberías ver una sección OpenAI API.

    En la página Settings que se abre, haz clic en Connections, dentro de AI, en la barra lateral izquierda (enmarcada en rojo)
  5. Añade una conexión con la URL y tu clave de API

    En la sección OpenAI API, haz clic en + a la derecha. Establece la URL en https://api.aicodewith.ai/v1, pega tu clave de API (Obtén una clave de API) y haz clic en Save.

    En la sección OpenAI API, haz clic en + a la derecha para abrir Add Connection: establece la URL en https://api.aicodewith.ai/v1, pega tu API Key y luego haz clic en Save
  6. Comprueba que la conexión está habilitada

    Después de guardar, la conexión https://api.aicodewith.ai/v1 aparece en OpenAI API con su interruptor activado.

    Después de guardar, la conexión https://api.aicodewith.ai/v1 aparece en OpenAI API y está habilitada (recuadro rojo)
  7. ¿Quieres comprobarlo? Abre la conexión

    Haz clic en el engranaje junto a la conexión para abrir Edit Connection y comprobar la URL. La clave de API permanece enmascarada con puntos.

    Haz clic en el engranaje junto a la conexión para abrir Edit Connection: la URL es https://api.aicodewith.ai/v1, y la clave de API de abajo permanece enmascarada con puntos (Bearer)
  8. Elige un modelo en un chat nuevo

    Inicia un chat nuevo y abre el selector de modelos. Si aparecen claude-haiku-4-5-20251001 y otros modelos, la URL es correcta; si la clave es correcta se ve en el paso 9, cuando recibas una respuesta.

    Abre el selector de modelos; aparecen los modelos servidos por aicodewith, con claude-haiku-4-5-20251001 enmarcado en rojo
  9. Envía un mensaje de prueba

    Selecciona claude-haiku-4-5-20251001 y envía Reply with exactly: Hello from aicodewith.ai. Una respuesta Hello from aicodewith.ai significa que has terminado.

    Selecciona claude-haiku-4-5-20251001 y envía “Reply with exactly: Hello from aicodewith.ai”; el modelo responde Hello from aicodewith.ai (enmarcado)
  10. Cómo se ve una URL incorrecta: OpenAI: Network Problem

    Si la URL es incorrecta (por ejemplo, https://api.aicodewith.ai/nope), al hacer clic en verify (icono de actualizar) aparece OpenAI: Network Problem en la parte superior derecha. Consulta Errores comunes para la solución.

    Si la URL es incorrecta (p. ej., termina en /nope), al hacer clic en verify (icono de actualizar) aparece el aviso "OpenAI: Network Problem" en la parte superior derecha (enmarcado)
  11. Vuelve a poner la URL en /v1 y chatea de nuevo

    Vuelve a poner la URL en https://api.aicodewith.ai/v1 y guarda. En un chat nuevo, una respuesta Hello from aicodewith.ai significa que vuelve a funcionar.

    Después de restaurar la URL a https://api.aicodewith.ai/v1 y guardar, un chat nuevo vuelve a responder Hello from aicodewith.ai, lo que confirma que la configuración se ha restaurado

Errores comunes

OpenAI: Network Problem

Qué ves

OpenAI: Network Problem
Causa
La URL de conexión es incorrecta (por ejemplo, https://api.aicodewith.ai/nope), así que verificar (icono de actualizar) no puede conectarse
Cómo corregirlo
Establece la URL en https://api.aicodewith.ai/v1 y guarda; un nuevo chat responderá normalmente

Volver al paso 5: Añade una conexión con la URL y tu clave de API →

Si la URL es incorrecta (p. ej., termina en /nope), al hacer clic en verificar (icono de actualizar) aparece el aviso "OpenAI: Network Problem" arriba a la derecha (en un recuadro)

Preguntas frecuentes

¿Cómo uso mi propia clave de API en Open WebUI?

En Panel de administración → Ajustes → Conexiones, haz clic en + en la sección OpenAI API, establece la URL en https://api.aicodewith.ai/v1, pega tu clave de API y guarda.

¿Necesito introducir de nuevo la clave de API de Open WebUI?

No. La clave se almacena en la propia base de datos de Open WebUI y sobrevive a un reinicio, sin necesidad de variables de entorno.

¿Cómo compruebo la versión de Open WebUI?

open-webui no tiene una opción --version. Si lo instalaste con uv, ejecuta uv tool list | grep open-webui.

Open WebUI dice OpenAI: Network Problem. ¿Y ahora qué?

La URL de conexión es incorrecta. Establécelo en https://api.aicodewith.ai/v1 y guarda; consulta Errores comunes arriba.

Fuentes

Enlaces relacionados