ES ▾

Configura la API compatible con OpenAI de Open WebUI en 5 minutos

Para usar la configuración de la API compatible con OpenAI de open webui, agregas una conexión con una URL base y una clave, y el modelo aparece en el selector. Aquí tienes la configuración exacta para el Abliterated API, desde Docker hasta el primer chat.

Actualizado

Interfaz de chat vinculada por un cable brillante a un servidor de API alojado, representando una conexión de Open WebUI

Puntos clave

  • La URL base es https://api.abliteratedapi.com/v1 y el ID del modelo es uncensored.
  • Agrégalo en la configuración de conexiones de administrador, o pasa OPENAI_API_BASE_URL y OPENAI_API_KEY a Docker.
  • Prueba la clave con curl primero, para que puedas distinguir un problema de la clave de un problema de la interfaz.
  • Open WebUI es solo la interfaz frontal: pagas por token por lo que el modelo lee y escribe, y no se necesita tarjeta para comenzar.

La versión corta

Si quieres la configuración de la API compatible con OpenAI de open webui en un párrafo: abre la configuración de administrador, agrega una conexión de API de OpenAI, establece la URL en https://api.abliteratedapi.com/v1, pega tu clave, guarda y selecciona el modelo llamado uncensored. Eso es todo. Open WebUI se comunica con cualquier cosa que implemente el formato de finalización de chat de OpenAI, y esta API lo hace.

El servicio es una API de texto alojada y compatible con OpenAI que ejecuta un modelo de pesos abiertos, ajustado para responder sin rechazos de contenido para uso adulto legal. Lo ejecuta un proveedor independiente y no es la API oficial de ningún laboratorio de modelos. Open WebUI es solo la interfaz de chat con la que te conectas.

Antes de comenzar

  • Una clave de API. Crea una en la página de la clave de API. El registro es con Google o con correo electrónico y contraseña. Los nuevos usuarios pueden reclamar $0,50 de crédito de prueba con un solo clic en esa página, válido durante 7 días y sin necesidad de tarjeta.
  • Un Open WebUI en ejecución. Una instalación con Docker o una instalación con pip funcionan ambas. Los pasos siguientes cubren Docker y la pantalla de configuración.
  • Acceso a la red desde la máquina que ejecuta Open WebUI a api.abliteratedapi.com por HTTPS.

Verifica la clave antes de tocar la interfaz. Si esta llamada devuelve una lista que contiene uncensored, la clave y la URL son correctas:

curl https://api.abliteratedapi.com/v1/models   -H "Authorization: Bearer $ABLITERATED_API_KEY"

Luego confirma que un completado funciona:

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

Método 1: agregar la conexión en la configuración

Esta es la ruta más fácil y funciona en una instalación existente. Las etiquetas del menú cambian entre versiones de Open WebUI, por lo que los nombres a continuación pueden diferir ligeramente.

  1. Inicia sesión en Open WebUI como administrador y abre el Panel de administración, luego Configuración, luego Conexiones.
  2. Busca la sección API de OpenAI y agrega una nueva conexión con el botón más.
  3. En el campo de URL ingresa https://api.abliteratedapi.com/v1. Detente en /v1. No agregues /chat/completions; Open WebUI añade la ruta por sí mismo.
  4. Pega tu clave en el campo. Se envía como Authorization: Bearer <key>.
  5. Usa el botón de verificación junto a los campos si tu versión tiene uno, luego guarda.

Abre un nuevo chat y abre el selector de modelos. El modelo uncensored debería estar en la lista, porque Open WebUI lo lee desde GET /v1/models. Si la lista permanece vacía, ve a la sección de solución de problemas a continuación.

Método 2: configurarlo al inicio con Docker

Para una instalación nueva, pasa el endpoint como variables de entorno. Open WebUI lee OPENAI_API_BASE_URL y OPENAI_API_KEY cuando inicia.

# base URL: https://api.abliteratedapi.com/v1   model to pick in the UI: uncensored
docker run -d -p 3000:8080   -e OPENAI_API_BASE_URL="https://api.abliteratedapi.com/v1"   -e OPENAI_API_KEY="$ABLITERATED_API_KEY"   -v open-webui:/app/backend/data   --name open-webui --restart always   ghcr.io/open-webui/open-webui:main

Luego visita http://localhost:3000, crea la primera cuenta (se convertirá en administrador) e inicia un chat. El volumen nombrado mantiene tus chats y configuraciones cuando actualizas el contenedor.

Una cosa sorprende a la gente: muchas configuraciones de Open WebUI se guardan en su base de datos después del primer lanzamiento, y el valor guardado puede ganar sobre una variable de entorno posterior. Si cambias la clave o la URL en Docker y no pasa nada, cámbialo en la pantalla de Conexiones en su lugar, o restablece la configuración guardada.

Configuraciones que vale la pena ajustar

Una vez que los chats funcionan, algunas opciones mejoran la experiencia y mantienen la factura predecible.

Usa la ventana de contexto sensatamente

La ventana de contexto es de 100.000 tokens, compartida entre prompt y respuesta. Open WebUI reenvía el historial de chat en cada mensaje, por lo que una conversación larga se vuelve más costosa con cada turno. A $0,15 por 1M de tokens de entrada, un historial de 20.000 tokens cuesta $0,003 para enviar, lo cual es barato, pero se acumula a través de miles de mensajes. Inicia un nuevo chat para un nuevo tema.

Streaming y muestreo

Open WebUI transmite respuestas por defecto, y la API admite streaming sobre SSE. En los parámetros avanzados puedes ajustar temperatura, top_p, secuencias de parada, una semilla para salida reproducible y penalizaciones. Estos se pasan al modelo. Deja max_tokens vacío a menos que quieras un límite estricto, ya que es opcional.

Tareas en segundo plano

Open WebUI puede realizar llamadas adicionales a modelos en segundo plano para tareas como nombrar un chat. Cada una es una petición real que se descuenta de tu saldo y cuenta para los límites. Si notas llamadas que no escribiste, revisa la configuración del modelo de tareas y configúralo para que use un modelo que estés dispuesto a pagar, o desactiva las funciones auxiliares.

Preajustes y prompts del sistema

Open WebUI te permite guardar un preajuste de modelo en su sección de espacio de trabajo: un nombre, un modelo base, un prompt del sistema y parámetros predeterminados. Crea uno sobre uncensored para cada trabajo que hagas a menudo, como un asistente de edición, un revisor de código o un personaje para una sesión de ficción interactiva. Un prompt del sistema corto que establece el rol, el tono y el formato de las respuestas hace más que instrucciones largas pegadas en cada chat.

Aquí es donde el perfil del modelo ayuda. Es un modelo de pesos abiertos ajustado para responder sin rechazos de contenido para uso adulto lícito, lo que se adapta a ficción, juego de roles y aplicaciones tipo compañero para adultos, donde un rechazo en medio de una escena interrumpe el flujo. No cambia el límite estricto: sin contenido sexual que involucre a menores de edad, siempre. Mantén las configuraciones preestablecidas y las instancias compartidas dentro de esa norma y de la legislación de tu país.

Si otras personas usan tu instancia de Open WebUI, recuerda que todos comparten tu clave y sus límites. Una clave completa permite 8 peticiones simultáneas, por lo que un puñado de usuarios activos está bien, mientras que un grupo grande chateando a la vez puede alcanzar el límite. Darle a cada persona o equipo su propia clave distribuye la carga y hace que el saldo sea más fácil de rastrear.

Cuánto cuesta ejecutarlo

Pagas solo por tokens, desde crédito prepago: $0,15 por 1M de tokens de entrada y $0,50 por 1M de tokens de salida. Las peticiones fallidas o rechazadas no se cobran y el crédito no caduca. Un mensaje de chat típico con 3.000 tokens de historial y una respuesta de 400 tokens cuesta $0,00045 + $0,0002 = $0,00065, por lo que $10 de uso son aproximadamente 15.000 mensajes.

Las recargas van desde $20 hasta $500 en cualquier cantidad entera, con +5% desde $50, +10% desde $100 y +15% desde $200. Puedes pagar con cripto (USDT en TRC20, USDC en Base). Consulta la página de precios para los detalles. El saldo restante se devuelve en el encabezado X-Balance-USD de cada respuesta de API, si quieres monitorearlo desde un script.

Solución de problemas

SíntomaCausa probableSolución
La lista de modelos está vacíaURL o clave incorrectaEjecuta la prueba curl para /v1/models. La URL debe terminar en /v1.
Conexión rechazada o tiempo de espera desde DockerSin HTTPS saliente del contenedorVerifica la configuración de DNS, proxy y firewall en el host.
Error de autenticación en cada mensajeClave pegada con espacios o clave antiguaVuelve a copiar la clave desde la página de claves y vuelve a guardar.
Errores cuando varias personas chatean a la vezLímites de peticionesUna clave completa permite 8 peticiones simultáneas y 300 por minuto; una clave de prueba permite 2 y 60.
El chat largo deja de funcionarVentana de contexto llenaLa ventana es de 100.000 tokens. Inicia un nuevo chat o resume.

Si la prueba con curl pasa pero Open WebUI falla, el problema está en la configuración del front end. Si curl falla, verifica primero tu clave y saldo. La documentación de inicio rápido enumera todos los parámetros de petición, y el artículo sobre qué es y qué no es la API de chat sin censura explica el alcance del modelo, incluido el límite estricto: sin contenido sexual que involucre a menores de edad.

Preguntas y respuestas

¿Qué URL introduzco en Open WebUI?

Usa https://api.abliteratedapi.com/v1 y nada más. Open WebUI añade /chat/completions y /models por su cuenta.

¿Qué nombre de modelo elijo?

El ID del modelo es uncensored. Aparece en el selector de modelos una vez que la conexión se guarda y se carga la lista de modelos.

¿Necesito una tarjeta para probarlo?

No. Los nuevos usuarios pueden reclamar $0,50 de crédito de prueba con un solo clic en la página de la clave de API después del registro. Es válido durante 7 días y no requiere tarjeta.

¿Puedo ejecutarlo junto con modelos locales?

Sí. Open WebUI admite varias conexiones a la vez, por lo que este endpoint puede estar junto a modelos locales y cada uno aparece en el mismo selector de modelos.

¿Se usan mis chats para entrenamiento?

No. Los prompts enviados a la API no se usan para entrenamiento. El historial de chat almacenado por Open WebUI permanece en tu propia instalación.

Tu clave está a un formulario de distancia

Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.

Obtener clave de API