---
title: "Open WebUI: endpoint personalizado compatible con OpenAI"
description: "Agregue BroadNet Inference a Open WebUI como conexión compatible con OpenAI, permita sus IDs de modelo y resuelva fallos de verificación, respuestas vacías y 429."
url: https://broadrouter.com/es/guides/open-webui-openai-api/
lang: es
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traducido del inglés con ayuda de IA. [Lea el original en inglés](https://broadrouter.com/guides/open-webui-openai-api/) (actualizado el 2026-11-16).

# Cómo conectar Open WebUI a BroadNet Inference

Actualizado 2026-11-16

En Open WebUI, vaya a Settings > Connections en la sección de administración, haga clic en Add Connection en Manage OpenAI API Connections, ponga URL en https://inference.broadnet.ai/v1 y API Key con su clave de BroadNet; luego agregue IDs de modelo como broadnet/glm-5.3 a la lista permitida Model IDs y guarde.

Open WebUI es una interfaz de chat autoalojada. Se conecta a cualquier proveedor que implemente el protocolo de chat completions de OpenAI, y BroadNet Inference lo implementa. Los pasos siguen [la guía de Open WebUI para proveedores compatibles con OpenAI](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible).

## Configuración

1.  **Obtenga una clave de BroadNet.** Para una interfaz de chat que usan varias personas, lo adecuado es una clave de pago por uso. Consulte [claves de API y listas de IP permitidas](https://broadrouter.com/es/guides/api-keys-ip-allow-lists/).
    
2.  **Abra la página de conexiones.** Vaya a **Settings > Connections** en la sección de administración y busque **Manage OpenAI API Connections**.
    
3.  **Haga clic en Add Connection** y complete:
    
    | Campo | Valor |
    | --- | --- |
    | URL | `https://inference.broadnet.ai/v1` (sin barra final) |
    | API Key | su clave de BroadNet |
    | Model IDs | agregue cada ID de abajo, uno por uno, con el ícono **+** |
    
4.  **Agregue los IDs de modelo a mano.** Escriba `broadnet/glm-5.3`, haga clic en **+** y repita con los demás que quiera. La documentación de BroadNet describe `GET /v1/models` como metadatos públicos del catálogo para monitores, así que no dependa de él para llenar el selector de modelos.
    
5.  **Haga clic en Save.** La documentación de Open WebUI advierte que guardar no prueba la conexión.
    
6.  **Inicie un chat** y elija el modelo en el selector de modelos.
    

### Con variables de entorno

Si ejecuta Open WebUI en Docker, puede configurar la conexión al arrancar:

```bash
OPENAI_API_BASE_URL=https://inference.broadnet.ai/v1
OPENAI_API_KEY=your-broadnet-key
```

Para agregar BroadNet junto a una conexión de OpenAI existente, use las formas en plural, separadas por punto y coma: `OPENAI_API_BASE_URLS` y `OPENAI_API_KEYS`. `OPENAI_API_CONFIGS` define opciones por conexión, como `model_ids`, indexadas según la posición de la conexión en esa lista:

```bash
OPENAI_API_CONFIGS='{"0": {"enable": true, "model_ids": ["broadnet/glm-5.3", "broadnet/qwen3.8-27b"]}}'
```

La [referencia de variables de entorno de Open WebUI](https://docs.openwebui.com/reference/env-configuration) las marca como ajustes ConfigVar. Se leen en el primer arranque y se guardan en la base de datos. A partir de ahí, manda el panel de administración. Edite la conexión en **Settings > Connections** de la sección de administración, o configure `ENABLE_PERSISTENT_CONFIG=False` si quiere que el entorno se aplique en cada arranque.

## Qué modelo elegir

| Uso | Modelo | Contexto |
| --- | --- | --- |
| Chat general, herramientas, JSON | `broadnet/glm-5.3` | 1,048,576 |
| Preguntas sobre imágenes, árabe | `broadnet/qwen3.8-27b` | 262,144 |
| Documentos largos, imágenes | `broadnet/deepseek-v4.1-flash` | 1,048,576 |
| Bajo costo, crédito gratuito | `broadnet/gemma-4-26b-a4b` | 32,768 |

BroadNet probó Qwen3.8 27B en árabe, incluidos los dialectos del Golfo y egipcio; consulte [cómo elegir un LLM para árabe](https://broadrouter.com/es/blog/choosing-an-llm-for-arabic/). Gemma 4 VL 26B es el único modelo de chat que funciona con el crédito inicial de $5; el crédito también cubre los dos modelos Transcribe. Los precios de cada uno están en la [página de precios](https://broadrouter.com/es/pricing/).

Open WebUI envía parámetros estándar como `temperature` y `max_tokens`, y admite el uso de herramientas cuando el modelo y el servidor admiten `tools`. BroadNet indica herramientas para GLM 5.3 y Qwen3.8 27B.

## Solución de problemas

-   **Verify Connection falla con 400, 401 o 403.** El botón de verificación de Open WebUI llama a `/models`. Su documentación indica que chat completions puede seguir funcionando. Agregue los IDs a la lista permitida y pruebe un chat. Si el chat también devuelve 401, la clave es incorrecta, venció o se quedó sin saldo de pago por uso.
-   **El modelo aparece en la lista, pero falla el primer mensaje.** Verifique que el ID coincida exactamente con el de BroadNet, con el prefijo `broadnet/`. GLM 5.3, Qwen3.8 27B y DeepSeek V4.1 Flash requieren una recarga.
-   **Respuestas vacías.** Los modelos de razonamiento (DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B) gastan primero tokens de salida en razonar. Si definió **max\_tokens** en los **Advanced Params** del modelo, auméntelo o bórrelo. [Por qué las respuestas llegan vacías](https://broadrouter.com/es/guides/reasoning-tokens-empty-response/).
-   **429 cuando chatean varias personas.** Una clave de pago por uso permite 30 solicitudes por minuto y 4 a la vez. Open WebUI también hace llamadas en segundo plano con la misma clave, por ejemplo para generar los títulos de los chats. Consulte [errores y reintentos](https://broadrouter.com/es/guides/errors-and-retries/).
-   **Cambiar las variables de entorno no tiene efecto.** El primer arranque guardó los valores anteriores. Edite la conexión en el panel de administración, o vea la sección de variables de entorno de arriba.
-   **Uso de una clave de plan.** Una [sesión de plan ilimitado](https://broadrouter.com/es/guides/unlimited-llm-api-sessions/) ejecuta una solicitud a la vez, y las claves no se pueden compartir. Sirve para la instancia propia de una persona; las solicitudes de usuarios adicionales hacen fila.

## Términos de esta guía

[Pago por uso (pay-as-you-go)](https://broadrouter.com/es/glossary/pay-as-you-go/)

El pago por uso es un modelo de precios en el que usted paga solo lo que usa, medido por unidades como tokens, solicitudes o minutos de audio, sin suscripción ni compromiso mínimo. La mayoría de las APIs de LLM cobran así, desde un saldo prepagado o con una factura periódica.

[Llamadas a herramientas (tool calling)](https://broadrouter.com/es/glossary/tool-calling/)

Las llamadas a herramientas (tool calling), también llamadas function calling, son una función de las APIs de LLM en la que el modelo devuelve una solicitud estructurada para ejecutar una función definida por el desarrollador, con argumentos JSON. La aplicación ejecuta la función y devuelve el resultado; el modelo nunca ejecuta código.

[Token](https://broadrouter.com/es/glossary/token/)

Un token es la unidad de texto que un modelo de lenguaje lee y escribe: una palabra, parte de una palabra, un signo de puntuación o una secuencia de bytes producida por el tokenizador del modelo. Las APIs de LLM cuentan, limitan y normalmente facturan el uso en tokens.

[API de Chat Completions](https://broadrouter.com/es/glossary/chat-completions-api/)

La API de Chat Completions es el endpoint HTTP de OpenAI, POST /v1/chat/completions, que recibe un nombre de modelo y una lista de mensajes etiquetados con su rol y devuelve el siguiente mensaje del modelo. Su forma de solicitud y respuesta se convirtió en el formato común que reutilizan los proveedores y SDKs compatibles con OpenAI.

[Concurrencia (concurrency)](https://broadrouter.com/es/glossary/concurrency/)

La concurrencia es el número de solicitudes que un cliente tiene en curso al mismo tiempo. Las APIs de LLM suelen limitarla por clave o por plan, aparte de las solicitudes por minuto, porque cada solicitud abierta ocupa capacidad de GPU hasta que su respuesta termina.

[Límite de frecuencia (rate limit)](https://broadrouter.com/es/glossary/rate-limit/)

Un límite de frecuencia (rate limit) es un tope que una API impone a cuánto puede usarla un cliente en un periodo, como solicitudes por minuto o tokens por minuto. Las solicitudes que lo superan se rechazan, normalmente con HTTP 429 Too Many Requests, hasta que el uso vuelve a quedar por debajo.

[Clave de API (API key)](https://broadrouter.com/es/glossary/api-key/)

Una clave de API es una cadena secreta que identifica y autoriza a un cliente que llama a una API. Las APIs de LLM suelen esperarla en un encabezado Authorization: Bearer, y cualquiera que tenga la clave puede hacer solicitudes que se facturan a la cuenta propietaria.

[Crédito prepago (prepaid credit)](https://broadrouter.com/es/glossary/prepaid-credit/)

El crédito prepago es dinero que se añade a una cuenta de API antes de usarla. Cada solicitud descuenta su coste del saldo y, cuando el saldo se agota, las solicitudes medidas se detienen hasta que usted recargue. Limita el gasto a lo que ha pagado.

## Preguntas frecuentes

### ¿Por qué falla Verify Connection si el chat funciona?

El botón de verificación de Open WebUI llama al endpoint /models del proveedor. Su documentación indica que una verificación fallida no significa que el chat no funcione. Agregue a mano los IDs de modelo de BroadNet a la lista permitida Model IDs.

### ¿Puedo configurar la conexión con variables de entorno?

Sí. Defina OPENAI\_API\_BASE\_URL como https://inference.broadnet.ai/v1 y OPENAI\_API\_KEY con su clave de BroadNet. Open WebUI guarda estos valores en el primer arranque, así que los cambios posteriores en las variables se ignoran salvo que ENABLE\_PERSISTENT\_CONFIG sea False.

### ¿Por qué no se aplicó mi nuevo valor de OPENAI\_API\_BASE\_URL?

Open WebUI la trata como una ConfigVar. Después del primer arranque usa el valor guardado en su base de datos. Cambie la URL en Settings > Connections, en la sección de administración, o configure ENABLE\_PERSISTENT\_CONFIG=False para que lea el entorno en cada arranque.

### ¿Puede todo mi equipo compartir una clave de plan ilimitado en Open WebUI?

No. Los planes de BroadNet no permiten compartir una clave, y una sesión de plan ejecuta una solicitud a la vez. Use una clave de pago por uso para un Open WebUI compartido.

## Guías relacionadas

-   [Agregar BroadNet Inference a LibreChat como endpoint personalizado](https://broadrouter.com/es/guides/librechat-custom-endpoint/)
-   [¿Por qué un modelo de razonamiento devuelve una respuesta vacía?](https://broadrouter.com/es/guides/reasoning-tokens-empty-response/)
-   [Cómo funcionan los planes de API de LLM ilimitada para agentes](https://broadrouter.com/es/guides/unlimited-llm-api-sessions/)
-   [Códigos de error de BroadNet Inference y cuándo reintentar](https://broadrouter.com/es/guides/errors-and-retries/)
-   [Todas las herramientas que funcionan con BroadNet Inference (en inglés)](https://broadrouter.com/integrations/): SDK, agentes de programación, interfaces de chat y herramientas de automatización, con la configuración exacta de cada una

Pruébelo con su carga de trabajo real. Las cuentas nuevas empiezan con USD 5 de crédito para Gemma y transcripción. DeepSeek, GLM y Qwen3.8 requieren una recarga.

[Comenzar](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-guides-open-webui-openai-api&utm_content=page-cta) ·

**Fuentes**

-   [Documentación de Open WebUI, proveedores compatibles con OpenAI (consultada el 2026-11-16)](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible)
-   [Documentación de Open WebUI, configuración por variables de entorno (consultada el 2026-11-14)](https://docs.openwebui.com/reference/env-configuration)
-   [Referencia de la API de BroadNet Inference (en inglés)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-guides-open-webui-openai-api&utm_content=sources)
