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.
Admin Panel → Settings → Connections → OpenAI API → +
URL: https://api.aicodewith.ai/v1
API Key: sk-***
Save → new chat → model selector → claude-haiku-4-5-20251001Pasos 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.
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.
¿Aún no tienes Open WebUI? Instálalo (omite esto si ya está instalado)
Ejecuta
uv tool install open-webui, luegouv tool list | grep open-webui. Si aparece open-webui con una versión, está instalado. Después ejecutaopen-webui servey 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) 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 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) 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) 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 Comprueba que la conexión está habilitada
Después de guardar, la conexión
https://api.aicodewith.ai/v1aparece 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) ¿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) Elige un modelo en un chat nuevo
Inicia un chat nuevo y abre el selector de modelos. Si aparecen
claude-haiku-4-5-20251001y 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 Envía un mensaje de prueba
Selecciona
claude-haiku-4-5-20251001y envíaReply with exactly: Hello from aicodewith.ai. Una respuestaHello from aicodewith.aisignifica 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) 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) apareceOpenAI: Network Problemen 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) Vuelve a poner la URL en /v1 y chatea de nuevo
Vuelve a poner la URL en
https://api.aicodewith.ai/v1y guarda. En un chat nuevo, una respuestaHello from aicodewith.aisignifica 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 →
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
- Documentación de Open WebUI compatible con OpenAI
- Inicio rápido de Open WebUI
- Repositorio de GitHub de Open WebUI