Tool Integrations29 de junio de 2026Flatkey

URL base de la API de OpenAI para Open WebUI: Guía de configuración de Flatkey

Configura Open WebUI con Flatkey como un enrutador compatible con OpenAI: URL base, clave de API, filtros de modelo, comprobaciones previas con curl, verificaciones de streaming y revisión de uso.

La configuración de la URL base de la API de OpenAI para Open WebUI es el pequeño campo que decide si Open WebUI envía el tráfico de chat a un proveedor ascendente, un servidor de modelos local o un enrutador como Flatkey. Para una implementación en equipo, ese campo no debe tratarse como un detalle de copiar y pegar. Debe verificarse con la clave de API, los ID de modelo, el comportamiento de descubrimiento de modelos, las finalizaciones de chat, la transmisión y los registros de uso.

Esta guía está escrita para desarrolladores, equipos de productos de IA, creadores de automatización, ingenieros de plataforma, operadores financieros y revisores de adquisiciones que desean que Open WebUI utilice Flatkey como un enrutador de modelos compatible con OpenAI. Muestra la ruta de conexión actual de Open WebUI, la URL base de Flatkey que se debe verificar, cuándo usar filtros de modelo, cómo ejecutar una comprobación previa con curl y qué registrar antes de implementar la configuración para más usuarios.

Nota sobre la fuente: esto se verificó el 29 de junio de 2026 con la documentación oficial de Open WebUI compatible con OpenAI, la página de inicio de Flatkey en vivo y la página de precios de Flatkey en vivo. No había ninguna clave de API de Flatkey ni instancia de Open WebUI en vivo disponible en este tiempo de ejecución, por lo que los comandos a continuación son plantillas para ejecutar con su propia clave, alias de modelo e implementación de Open WebUI.

Respuesta rápida: URL base de la API de OpenAI para Open WebUI para Flatkey

Para una ruta de Flatkey, establezca la URL base de la API de OpenAI para Open WebUI en la URL base del proveedor de Flatkey actual de su cuenta. La página de inicio pública de Flatkey consultada para este artículo indica que se debe apuntar a los clientes compatibles con OpenAI a https://console.flatkey.ai/v1. En Open WebUI, use esa URL base, pegue una clave de API de Flatkey, agregue los ID de modelo exactos de Flatkey si el descubrimiento de modelos es ruidoso o falla, y luego guarde la conexión.

Campo de Open WebUI	Valor de Flatkey	Verificación de revisión
URL	`https://console.flatkey.ai/v1`, a menos que su cuenta de Flatkey muestre una URL base de proveedor más reciente	Use solo la URL base. No pegue `/chat/completions` en el campo de la URL.
Clave de API	Una clave de Flatkey propiedad del espacio de trabajo, equipo o entorno correcto	Use primero una clave de prueba con alcance limitado, luego rote o separe las claves para los usuarios de producción.
ID de modelo (Filtro)	Alias de modelo de Flatkey exactos aprobados para Open WebUI	Agréguelos manualmente cuando la verificación de `/models` falle, devuelva demasiados modelos o exponga modelos que no desea que los usuarios seleccionen.
Interruptor de conexión	Habilitado solo después de una comprobación previa de chat exitosa	Mantenga el proveedor anterior disponible hasta que se demuestre que la ruta de Flatkey funciona.

La versión corta es: configure la URL, la clave y el filtro de modelo, luego pruebe una solicitud de chat y confirme que la solicitud aparece en el uso de Flatkey. El resto de esta guía sobre la URL base de la API de OpenAI para Open WebUI convierte eso en una lista de verificación repetible para la configuración y la solución de problemas.

Lo que confirman los documentos actuales de Open WebUI

La guía oficial de Open WebUI compatible con OpenAI dice que Open WebUI puede conectarse a cualquier servidor o proveedor que implemente la API compatible con OpenAI. La documentación enmarca la integración en torno a protocolos estándar, especialmente el protocolo de finalizaciones de chat de OpenAI, en lugar de un módulo personalizado para cada proveedor. Eso convierte a Flatkey en una tarea de configuración de URL base, clave y selección de modelo.

La misma guía proporciona la ruta de administración actual: abra Open WebUI, vaya a Configuración de administrador, luego a Conexiones, luego a OpenAI y haga clic en Agregar conexión. Desde allí, complete la URL del proveedor y la clave de API. Si el descubrimiento automático de modelos no funciona, agregue los ID de modelo a ID de modelo (Filtro) y guarde.

Una advertencia de Open WebUI es especialmente importante para las configuraciones de enrutador. Cuando se agrega una conexión, Open WebUI la verifica a través del punto de conexión /models del proveedor con un token de portador estándar. La documentación dice que algunos proveedores no implementan /models, usan un comportamiento no estándar o devuelven una lista de modelos difícil de manejar. Un error en la lista de modelos no significa automáticamente que las finalizaciones de chat sean incompatibles. Significa que es posible que deba agregar los ID de modelo manualmente y probar el punto de conexión de chat directamente.

Para una compatibilidad total, Open WebUI enumera /v1/models como recomendado y /v1/chat/completions como el punto de conexión de chat principal requerido. También pasa parámetros comunes de OpenAI como temperature, top_p, max_tokens o max_completion_tokens, stop, seed y logit_bias. El uso de herramientas es compatible cuando el modelo y el servidor admiten tools y tool_choice.

Valores de Flatkey que se deben verificar antes de cambiar Open WebUI

La página de inicio de Flatkey consultada el 29 de junio de 2026 tiene el título One API gateway for production AI teams y describe el acceso unificado a modelos, el enrutamiento, la facturación, el análisis de uso y los controles operativos. También dice que los equipos deben apuntar un cliente compatible con OpenAI a https://console.flatkey.ai/v1 y mantener el SDK o el patrón de cliente existente.

La página de precios de Flatkey, consultada el mismo día, indica que el catálogo público tiene 633 modelos habilitados de 23 proveedores. También expone familias de endpoints, incluyendo /v1/chat/completions, /v1/responses, /v1/messages, /v1/images/generations y /v1/video/generations. Para el chat de Open WebUI, comience con un modelo que esté disponible a través de la ruta de finalización de chat y que esté aprobado para la clave que planea usar.

No asuma que todos los modelos del catálogo son buenos para Open WebUI. La URL base de la API de OpenAI para Open WebUI apunta a un enrutador, pero la experiencia del usuario depende del alias del modelo elegido, el soporte del endpoint, la latencia, el comportamiento del contexto, el soporte de herramientas y si el modelo aparece correctamente en el selector de modelos de Open WebUI.

Paso a paso: agregar Flatkey como la conexión de OpenAI

Elija el alcance de Open WebUI. Decida si se trata de una conexión para toda la administración, una instancia de prueba o una implementación autohospedada gestionada a través de variables de entorno.
Cree o seleccione una clave de Flatkey. Use una clave dedicada para la prueba de Open WebUI para que el uso pueda ser atribuido y limitado.
Elija un modelo de partida. Copie el alias exacto del modelo desde la página de precios de Flatkey, la consola de Flatkey o su lista de modelos visibles en la cuenta.
Abra la pantalla de conexión. En Open WebUI, vaya a Configuración de administrador > Conexiones > OpenAI > Agregar conexión.
Pegue la URL de Flatkey. Use https://console.flatkey.ai/v1 si su cuenta lo confirma. El valor debe incluir /v1 pero no /chat/completions.
Pegue la clave de Flatkey. Use la clave creada para esta implementación de Open WebUI, no una clave de proveedor personal ni una clave de proveedor ascendente no relacionada.
Agregue los ID de modelo cuando sea necesario. Si el descubrimiento de modelos falla, devuelve demasiadas opciones o expone modelos fuera de la política, agregue los alias exactos aprobados a ID de modelo (Filtro).
Guarde y mantenga la ruta anterior a mano. Open WebUI permite habilitar o deshabilitar conexiones, así que conserve una ruta de reversión mientras realiza las pruebas.
Ejecute una indicación de bajo riesgo. Use una indicación simple en Open WebUI, luego confirme la solicitud en el uso de Flatkey por marca de tiempo, clave, modelo, recuento de tokens y costo.
Documente el propietario. Registre quién es el propietario de la clave, quién puede rotarla, qué modelos están aprobados y qué cuota se aplica antes de ampliar el acceso.

Plantilla opcional de variables de entorno

Si su implementación se gestiona a través de variables de entorno, use los nombres compatibles con su versión y método de implementación de Open WebUI. Los ejemplos de proveedores de Open WebUI muestran patrones OPENAI_API_BASE_URL y OPENAI_API_KEY para backends compatibles con OpenAI, pero el panel de administración también puede gestionar las conexiones. Trate esto como una plantilla de implementación para verificarla con su versión.

OPENAI_API_BASE_URL=https://console.flatkey.ai/v1
OPENAI_API_KEY=fk_replace_with_flatkey_key

Si también enruta incrustaciones, generación de imágenes, voz u otras características de estilo OpenAI a través de Open WebUI, configure esas variables de URL base y clave específicas de la característica solo después de confirmar que Flatkey y el modelo seleccionado admiten esa familia de endpoints. Para el primer despliegue de la URL base de la API de OpenAI para Open WebUI, mantenga la prueba centrada en las finalizaciones de chat.

Verificación previa de la ruta de Flatkey antes de culpar a Open WebUI

Una verificación previa con curl separa los problemas del enrutador y las credenciales de los problemas de la interfaz de usuario de Open WebUI. Ejecute esto desde una ubicación de red comparable a la del servidor de Open WebUI.

export FLATKEY_API_KEY="fk_replace_me"
export FLATKEY_BASE_URL="https://console.flatkey.ai/v1"
export FLATKEY_OPEN_WEBUI_MODEL="replace-with-flatkey-model-alias"

curl "$FLATKEY_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$FLATKEY_OPEN_WEBUI_MODEL"'",
    "messages": [
      {
        "role": "user",
        "content": "Return the word ok."
      }
    ],
    "stream": false,
    "max_tokens": 16
  }'

Si esa solicitud falla, corrija la clave de Flatkey, la URL, el alias del modelo, el permiso de la cuenta o la ruta de red antes de volver a cambiar Open WebUI. Si tiene éxito, repita el proceso a través de Open WebUI y compare el registro de uso de Flatkey.

Para una experiencia de chat con streaming, pruebe el streaming por separado. Una respuesta sin streaming demuestra que la ruta puede responder. No demuestra que su proxy inverso, la implementación de Open WebUI y el navegador del cliente manejen el streaming sin almacenamiento en búfer ni tiempos de espera.

curl "$FLATKEY_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$FLATKEY_OPEN_WEBUI_MODEL"'",
    "messages": [
      {
        "role": "user",
        "content": "Stream three short bullet points."
      }
    ],
    "stream": true,
    "max_tokens": 96
  }'

Lista de verificación de descubrimiento y filtro de modelos

La configuración más segura de la URL base de la API de OpenAI para Open WebUI utiliza filtros de modelos de forma intencionada. Un enrutador puede exponer muchos modelos, y una lista amplia de modelos no siempre es lo que los administradores quieren que los usuarios vean.

Decisión	Qué comprobar	Por qué es importante
Alias del modelo	ID exacto del modelo de Flatkey visible para la clave	Open WebUI envía la cadena del modelo tal como está configurada. Un nombre para mostrar no es suficiente.
Descubrimiento de `/models`	Comportamiento al guardar la conexión y salida del selector de modelos	Open WebUI puede mostrar un error de verificación incluso cuando las finalizaciones de chat pueden funcionar a través de una lista de permitidos manual.
Finalizaciones de chat	`/v1/chat/completions` devuelve una respuesta normal	Esta es la ruta de chat de Open WebUI requerida en la tabla de compatibilidad oficial.
Streaming	El navegador recibe una salida incremental sin un búfer prolongado	El streaming puede fallar debido al comportamiento del proxy o del tiempo de ejecución, incluso cuando el chat sin streaming funciona.
Herramientas	El modelo y la ruta admiten `tools` y `tool_choice` cuando es necesario	Open WebUI solo puede pasar parámetros de herramientas si el backend seleccionado los admite.
Visibilidad del uso	Flatkey muestra la marca de tiempo, la clave, el modelo, los tokens, el estado y el coste	Los equipos de plataforma y finanzas necesitan pruebas de que la nueva ruta es atribuible.

Modos de fallo que depurar primero

Síntoma	Causa probable	Solución
Al guardar la conexión se muestra un error de lista de modelos	El descubrimiento de `/models` falló, devolvió demasiados modelos o no coincidió con las expectativas de Open WebUI	Añada los ID exactos de los modelos a ID de modelos (Filtro), guarde de nuevo y pruebe las finalizaciones de chat.
401 o clave no válida	La clave no es una clave de Flatkey, se copió incorrectamente, fue rotada o pertenece al espacio de trabajo equivocado	Genere una clave de Flatkey dedicada y vuelva a probar con curl antes de actualizar la interfaz de usuario.
404 o ruta no encontrada	La URL incluye el punto de conexión completo o le falta la ruta base requerida	Use `https://console.flatkey.ai/v1` como URL base cuando su cuenta lo confirme.
Modelo no encontrado	El valor del modelo de Open WebUI no coincide con un alias de Flatkey habilitado	Copie el alias exacto del modelo desde Flatkey y añádalo al filtro de modelos.
El chat funciona, pero el streaming parece atascado	Búfer del proxy inverso, tiempo de espera del servidor o problema en la ruta del navegador/red	Pruebe el streaming con curl y luego inspeccione la configuración de tiempo de espera del servidor y del proxy de Open WebUI.
El gasto no se puede conciliar	Clave compartida, propietario del modelo poco claro o sin registro de despliegue	Use una clave de Flatkey dedicada y registre el propietario, el entorno, los ID de los modelos y la cuota antes de ampliar el acceso.

Manual de operaciones de producción para Open WebUI más Flatkey

Antes de realizar el cambio de la URL base de la API de OpenAI para Open WebUI para un grupo más amplio, anote los datos operativos que respaldan la propiedad, la reversión y la revisión de costes.

Campo del manual de operaciones	Registre esto
Despliegue de Open WebUI	URL, versión si se conoce, propietario y si las conexiones son gestionadas por el administrador o por el entorno.
URL base de Flatkey	URL base actual aprobada por la cuenta y fecha de comprobación.
Propietario de la clave de Flatkey	Equipo, entorno, propietario de la rotación, cuota y propietario de la alerta.
Lista de modelos permitidos	Alias exactos de los modelos expuestos a los usuarios de Open WebUI y la razón por la que cada uno está aprobado.
Prueba del punto de conexión	Comprobaciones de chat sin streaming, chat con streaming y uso de herramientas cuando sea relevante.
Prueba de uso	Filas de uso de Flatkey que muestran la clave esperada, la marca de tiempo, el modelo, los tokens, el estado de la solicitud y el coste.
Reversión	Conexión anterior, plan de desactivación, ruta de revocación de clave y aprobación del propietario.

Dónde encaja esto en el clúster de integración de herramientas de Flatkey

Open WebUI es solo una de las superficies que puede utilizar una ruta compatible con OpenAI. Si su equipo está estandarizando varias herramientas, utilice el mismo patrón en todo el clúster: una URL base actual, una clave propiedad de la cuenta por superficie, alias de modelo exactos, una pequeña prueba de humo, prueba de uso y notas de reversión.

Para configuraciones adyacentes, consulte la guía de configuración de la API de Cherry Studio para la disciplina de la URL base del cliente de escritorio, la guía de CC Switch Claude Code Flatkey para el enrutamiento de herramientas de desarrollador y el manual más amplio de migración de API compatibles con OpenAI para cambios de URL base, verificación de alias de modelo y reversión. Use los precios de Flatkey para revisar la cobertura actual de modelos y puntos de conexión, y luego obtenga una clave para el espacio de trabajo que posee el primer despliegue de Open WebUI.

Preguntas frecuentes

¿Qué debo poner en el campo de la URL base de la API de OpenAI para Open WebUI?

Use la URL base actual del proveedor Flatkey de su cuenta. La página de inicio pública de Flatkey, comprobada el 29 de junio de 2026, dirige a los clientes compatibles con OpenAI a https://console.flatkey.ai/v1. No incluya la ruta completa /chat/completions en el campo de la URL base.

¿Por qué Open WebUI muestra un error de descubrimiento de modelos?

Open WebUI verifica una nueva conexión compatible con OpenAI llamando a /models. La documentación oficial advierte que algunos proveedores no implementan ese punto de conexión, usan un comportamiento no estándar o devuelven listas de modelos muy grandes. Si las finalizaciones de chat funcionan, agregue los ID de modelo exactos al filtro y vuelva a probar.

¿Puedo exponer todos los modelos de Flatkey a Open WebUI?

Técnicamente, un enrutador puede exponer muchos modelos, pero los administradores de producción deben comenzar con una lista de permitidos restringida. Elija modelos que coincidan con las necesidades de chat de Open WebUI, el soporte de puntos de conexión, las expectativas de latencia, la política de uso y los controles de presupuesto.

¿Flatkey reemplaza la configuración de Open WebUI?

No. Flatkey proporciona la ruta compatible con OpenAI, la clave, el acceso al modelo, la visibilidad del uso y los controles de facturación. Open WebUI todavía controla su propia configuración de conexión, selector de modelos, acceso de usuario, comportamiento de las indicaciones y redes a nivel de implementación.

¿Cómo sé que la configuración está funcionando?

Ejecute una comprobación previa con curl a /chat/completions, guarde la conexión de Open WebUI, envíe una indicación segura y confirme que la solicitud aparece en el uso de Flatkey con la clave, el modelo, la marca de tiempo, los tokens, el estado y el costo esperados.

Lista de verificación final

URL base de Flatkey confirmada desde la fuente de la cuenta actual.
Clave de Flatkey dedicada creada para la implementación de Open WebUI.
Un alias de modelo de chat aprobado seleccionado primero.
URL base de la API de OpenAI para Open WebUI establecida en la URL base del proveedor, no en el punto de conexión completo.
ID de modelo agregados manualmente cuando el descubrimiento falla o devuelve demasiadas opciones.
Chat con y sin transmisión probado.
Fila de uso de Flatkey confirmada después de la primera indicación de Open WebUI.
Propietario, cuota, lista de modelos permitidos y ruta de reversión registrados.

Una vez que se superan estas comprobaciones, la URL base de la API de OpenAI para Open WebUI se convierte en más que un campo de conexión. Se convierte en una ruta de Flatkey controlada con una clave, modelos aprobados, visibilidad de uso y un plan de reversión claro.