Endpoints de API de Open WebUI: Conecta un LLM sin censura

Los valores que necesitas

Open WebUI solo necesita tres cosas de este servicio. La primera es la URL base, https://api.dolphinllm.com/v1. La segunda es una clave de API de tu cuenta. La tercera es el ID del modelo, uncensored, que Open WebUI lee de la lista de modelos por sí misma una vez que la conexión funciona.

Hay dos endpoints implicados. GET /v1/models rellena el menú desplegable de modelos, y POST /v1/chat/completions gestiona todos los mensajes que envías. No se necesita nada más para el chat. Al ser una API de texto, las funciones de imagen, audio y embeddings de Open WebUI no tienen nada con qué interactuar aquí.

No necesitas una tarjeta para probarlo. Después del registro, puedes reclamar $0,50 de crédito de prueba con un clic en la página de claves. Dura 7 días.

Añade la conexión en el panel de administración

Si Open WebUI ya se está ejecutando, esta es la ruta más rápida.

1. Inicia sesión como administrador y abre Configuración de administrador, luego Conexiones.
2. En la sección API de OpenAI, haz clic en el botón más para añadir una conexión.
3. Pega https://api.dolphinllm.com/v1 como URL y tu clave como clave.
4. Usa el botón verificar junto a los campos. Una confirmación verde significa que la lista de modelos se devolvió.
5. Guarda, abre un nuevo chat y selecciona uncensored en el selector de modelos.

Los nombres de los menús cambian un poco entre versiones de Open WebUI. Si no encuentras Conexiones, busca "OpenAI" en la configuración. Los campos son siempre los mismos: URL, clave y a veces un filtro de modelo.

Configúralo con variables de entorno de Docker

Para una instalación nueva, puedes omitir la pantalla de administración y pasar la conexión cuando se inicie el contenedor. Open WebUI lee OPENAI_API_BASE_URL y OPENAI_API_KEY al inicio.

Copydocker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL="https://api.dolphinllm.com/v1" \
  -e OPENAI_API_KEY="YOUR_KEY" \
  -v open-webui:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main

Luego navega a http://localhost:3000, crea la primera cuenta (se convertirá en el administrador) y el modelo ya debería estar listado. Mantén la clave fuera del historial de shell si la máquina es compartida: ponla en un archivo de entorno y usa --env-file en su lugar.

Algunas versiones de Open WebUI tratan estas variables solo como valores iniciales. Una vez que hayas guardado una conexión en la interfaz, el valor almacenado prevalece. Si cambias la variable y no pasa nada, edita la conexión en Configuración de administrador en su lugar.

Ejecutarlo para varias personas

Open WebUI tiene sus propias cuentas de usuario, por lo que una sola instalación puede atender a un hogar o un equipo pequeño mientras solo una clave de API reside en el servidor. Eso es cómodo pero también un riesgo: cada usuario gasta del mismo saldo. Decide quién obtiene una cuenta y revisa de vez en cuando X-Balance-USD para que un fin de semana largo de roleplay no te sorprenda.

Mantén la clave en una variable de entorno o un archivo de secretos, nunca en una captura de pantalla o un documento compartido. Tu clave vive en la página Clave de API; si sospechas que se filtró, reemplázala en Open WebUI en cuanto tengas una nueva. Para una instalación pública, colócala detrás de HTTPS y desactiva el registro abierto para que los extraños no puedan crear cuentas y usar tu crédito.

Un punto más para configuraciones compartidas: el modelo está ajustado para responder sin rechazos de contenido para uso adulto legal. Eso es una característica para ficción e investigación privada, y también significa que tú decides las reglas de la casa. Un prompt de sistema en el modelo compartido es el lugar más fácil para escribirlos. No se permite nada sexual que involucre menores en la API, independientemente de lo que diga el prompt.

Buenos usos para esta configuración

Las personas que conectan Open WebUI a un endpoint sin censura generalmente quieren una ventana de chat limpia sin los límites de un chatbot alojado. Los usos comunes incluyen ficción de formato largo y construcción de mundos, roleplay y personajes compañeros para adultos, redacción de material que los asistentes principales se niegan a tocar, y ayuda de codificación o escritura ordinaria. El mismo modelo maneja todo esto, así que puedes cambiar tareas dentro de un solo chat.

Open WebUI ayuda de algunas formas específicas. Los prompts guardados y las configuraciones de modelo te permiten mantener un personaje o una personalidad de editor a un clic de distancia. La subida de documentos y las funciones de búsqueda web, donde las habilites, envían texto adicional al prompt, lo que aumenta el uso de tokens, así que vigila el tamaño de lo que adjuntas. Las carpetas de chat y la búsqueda facilitan volver a un proyecto largo.

Lo que no hará es generar imágenes, voz o video desde esta conexión, porque la API es solo de texto.

Prueba el endpoint antes de culpar a Open WebUI

La mayoría de las configuraciones fallidas provienen de un error tipográfico en la URL o una clave obsoleta, y ambos aparecen más rápido en una terminal. Ejecuta estas dos llamadas desde la máquina que aloja Open WebUI.

Copycurl https://api.dolphinllm.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

curl https://api.dolphinllm.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Say hello in five words."}]
  }'

La primera llamada debe incluir uncensored. La segunda debe devolver una respuesta de chat normal. Revisa también los encabezados de respuesta: X-Balance-USD muestra lo que queda en tu cuenta, lo cual es una forma práctica de confirmar que Open WebUI está gastando desde la clave que crees que es.

La lista completa de parámetros está en la documentación de API.

Configuraciones que vale la pena cambiar para el chat

Prompt de sistema y muestreo

Open WebUI te permite configurar un prompt del sistema por modelo o por chat. Como el modelo está ajustado para responder sin rechazos de contenido para uso adulto lícito, un prompt del sistema corto que fije el tono, la personalidad o el formato de salida hace más que una larga lista de reglas. La temperatura, top_p, stop, seed y las penalizaciones se pasan a través, de modo que los controles deslizantes de Open WebUI sí tienen efecto.

Longitud del contexto

La ventana es de 100.000 tokens para prompt más respuesta. Los chats largos hacen crecer el prompt en cada turno, y pagas por todo el historial cada vez. Si un hilo se vuelve pesado, inicia un nuevo chat o resume el anterior.

Peticiones en segundo plano

Open WebUI puede enviar llamadas adicionales en segundo plano para títulos y etiquetas de chat, usando el mismo modelo por defecto. Con una clave de prueba, que permite 2 peticiones simultáneas y 60 por minuto, esas llamadas pueden desplazar tu mensaje real. Desactiva la generación de títulos y etiquetas, o acepta un breve retraso. Una clave completa permite 8 peticiones simultáneas y 300 por minuto, lo cual es suficiente para una instalación personal o de equipo pequeño.

Streaming, modo JSON y herramientas

Open WebUI transmite respuestas por defecto, y la API admite eventos enviados por el servidor (stream: true), con un bloque de uso al final del flujo. Ves el texto aparecer token por token, y el encabezado de saldo en la respuesta final refleja lo que gastaste.

Las llamadas a herramientas también son compatibles con la API: tools, tool_choice, tool_calls en streaming, y los resultados enviados como role: "tool". Hasta qué punto Open WebUI expone esto depende de su versión y de las herramientas o funciones que instales, así que prueba con una herramienta pequeña antes de construir un flujo de trabajo alrededor de ella. El modo JSON (response_format establecido en json_object) es útil cuando llamas al mismo endpoint desde scripts junto con la interfaz de chat.

Un patrón práctico es mantener Open WebUI para las personas y usar la misma clave desde un script para trabajo por lotes. Ambos pasan por la misma URL base, así que un saldo cubre todo. Solo recuerda que los límites se aplican por clave: 8 peticiones simultáneas en una clave completa, compartidas entre la interfaz y tus scripts.

Errores comunes y soluciones

• No aparecen modelos. Es probable que la URL carezca de /v1 o tenga un error tipográfico. Compárala carácter por carácter con el valor anterior y elimina cualquier barra final.
• Error de autenticación. La clave se pegó con un espacio inicial o final, o pertenece a una cuenta eliminada. Cópiala nuevamente desde la página de claves.
• El selector de modelos muestra la lista incorrecta. Open WebUI también consulta otras conexiones que añadiste, como un Ollama local. Deshabilita las que no uses.
• Las respuestas dejan de aparecer a mitad del streaming. Un proxy inverso delante de Open WebUI puede almacenar en búfer los eventos enviados por el servidor. Desactiva el almacenamiento en búfer para esa ruta.
• El saldo se agota. Recarga antes de que llegue a cero. Las peticiones fallidas o rechazadas no se cobran, así que solo pagas por las completaciones que se entregaron.

Cuánto cuesta una interfaz de chat en esta API

Los precios son $0,15 por 1M de tokens de entrada y $0,50 por 1M de tokens de salida, descontados del crédito prepago. Considera un turno típico en un chat de longitud media: 4.000 tokens de historial de entrada y 500 tokens de salida. La entrada cuesta 4.000 x $0,15 / 1.000.000 = $0,0006. La salida cuesta 500 x $0,50 / 1.000.000 = $0,00025. El turno cuesta $0,00085.

A esa tasa, el crédito de prueba de $0,50 cubre unos 588 turnos, y una recarga de $20 cubre aproximadamente 23.500. Consulta la página de precios para ver los bonos de recarga. Si quieres usar la misma clave fuera de Open WebUI, por ejemplo en scripts que nunca necesitan una pantalla de inicio de sesión, la página sobre el uso de un LLM sin restricciones de inicio de sesión cubre ese caso.

Más guías

• API de LLM gratuita para desarrolladores: prueba vs. pago por uso
• Cómo usar un LLM sin restricciones de inicio de sesión