--- title: Open WebUI | RunAPI description: Instale Open WebUI, agregue RunAPI como una conexión compatible con OpenAI, seleccione un modelo y verifique un chat. url: https://runapi.ai/es/docs/resources/application-practices/open-webui.md canonical: https://runapi.ai/es/docs/resources/application-practices/open-webui locale: es --- > Versión HTML: https://runapi.ai/es/docs/resources/application-practices/open-webui > Índice del sitio para agentes: https://runapi.ai/llms.txt # Open WebUI Conecte Open WebUI a RunAPI a través de su Conexión compatible con OpenAI. Necesita acceso de administrador a Open WebUI y una Clave de API estándar de RunAPI de la [Guía de Autenticación](https://runapi.ai/es/docs/guides/authentication.md). ## Instalar Open WebUI Siga la [guía de inicio rápido oficial de Open WebUI][1] para su plataforma. Para una instalación local con Docker, puede iniciar la imagen oficial con: [1]: https://docs.openwebui.com/getting-started/quick-start/ ```shell docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main ``` Abra la aplicación, cree la cuenta de administrador e inicie sesión antes de agregar la conexión. ## Agregar la conexión de RunAPI 1. Abre **Admin Settings → Connections → OpenAI** y selecciona **Add Connection**. 2. Establece la URL en `https://runapi.ai/v1` e ingresa tu Clave de API de RunAPI. 3. Deja **Model IDs (Filter)** vacío en el primer intento de conexión para que Open WebUI pueda detectar los modelos disponibles. 4. Guarda la conexión y espera a que la verificación finalice. Open WebUI envía la verificación de conexión desde su backend y usa `GET /v1/models` para el descubrimiento. La URL de RunAPI es HTTPS pública, por lo que una instalación de Docker no necesita `host.docker.internal` para esta conexión. ## Seleccionar un modelo Abra un nuevo chat y seleccione un modelo de RunAPI desde el selector de modelos del chat. Use el [Catálogo de modelos](https://runapi.ai/es/models) para confirmar el identificador de modelo actual y las capacidades. Si el descubrimiento no rellena el selector, edite la conexión y agregue el identificador exacto en **Model IDs (Filter)**. Un error de descubrimiento de modelo y un error de Chat Completions son señales separadas; pruebe el modelo agregado manualmente antes de eliminar la conexión. ## Verificar la conexión Envíe un mensaje breve como `Reply with the word connected.` Una respuesta en streaming o completa normal confirma que Open WebUI puede usar el modelo de RunAPI seleccionado. ## Solución de problemas * **La verificación devuelve `401` o `403`:** reemplaza la clave de API en la conexión por una clave estándar válida de la [Guía de autenticación](https://runapi.ai/es/docs/guides/authentication.md). * **No aparece ningún modelo de RunAPI:** confirma que la URL termina en `/v1`, luego agrega un identificador actual en **Model IDs (Filter)** y vuelve a intentar el chat. * **El modelo es visible pero el chat falla:** confirma que el identificador admite Chat Completions compatible con OpenAI en el [Catálogo de modelos](https://runapi.ai/es/models) y luego inspecciona los registros del backend de Open WebUI para ver el estado de la solicitud. * **Una URL local funciona en el navegador pero no en Open WebUI:** las conexiones de Open WebUI se originan desde su backend. Esto no afecta a la URL pública `https://runapi.ai/v1`, pero sí importa para otras conexiones locales. Para el comportamiento de protocolo compartido, use el [Inicio rápido de la API LLM](https://runapi.ai/es/docs/guides/llm-api/quickstart.md). Para los campos de solicitud y respuesta, use la [Referencia de la API de Chat Completions](https://runapi.ai/es/docs/api/openai/chat-completions.md). --- ## Más de RunAPI - [Inicio](https://runapi.ai/es/.md) - [Catálogo de modelos](https://runapi.ai/es/models.md) - [Precios](https://runapi.ai/es/pricing.md) - [Proveedores](https://runapi.ai/es/models) - [Documentación](https://runapi.ai/es/docs/guides) - [SDKs](https://runapi.ai/es/sdk.md) - [CLI](https://runapi.ai/es/cli.md) - [Servidor MCP](https://runapi.ai/es/mcp.md) - [Claude Code vs Cursor](https://runapi.ai/es/claude-code-vs-cursor.md) - [Configuración de Cursor API](https://runapi.ai/es/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/es/openrouter-alternative.md) - [Enterprise](https://runapi.ai/es/contact.md) - [Contacto](https://runapi.ai/es/contact.md) - [Términos](https://runapi.ai/es/terms.md) - [Privacidad](https://runapi.ai/es/privacy.md) - [Índice del sitio para agentes](https://runapi.ai/llms.txt) Contacto: contact@runapi.ai ## Datos estructurados ```json [ { "@context": "https://schema.org", "inLanguage": "es", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/es", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/es/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "es", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/es", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/esicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "es", "@type": "TechArticle", "headline": "Open WebUI", "description": "Instale Open WebUI, agregue RunAPI como una conexión compatible con OpenAI, seleccione un modelo y verifique un chat.", "url": "https://runapi.ai/es/docs/resources/application-practices/open-webui", "mainEntityOfPage": "https://runapi.ai/es/docs/resources/application-practices/open-webui" } ] ```