ES ▾
Obtener clave de API

API compatible con OpenAI en n8n: Guía de configuración

Si buscaste "openai compatible api n8n", la respuesta corta es que solo cambias dos valores en la credencial de OpenAI: la URL base y la clave de API. El resto del flujo de trabajo se mantiene igual que con cualquier nodo de OpenAI.

Actualizado

Flujo de trabajo de automatización isométrico con bloques conectados enviando datos a un terminal de API

Puntos clave

Lo que necesitas antes de comenzar

Una instancia de n8n (en la nube o autoalojada) y una clave de API de este servicio. Si aún no tienes una clave, la página de clave de API te guía para registrarte con Google o con correo electrónico y contraseña. Los usuarios nuevos pueden reclamar $0,50 de crédito de prueba con un clic en esa página, válido durante 7 días y sin tarjeta.

Tres valores van en n8n:

  • URL base: https://api.onekeyllmapi.com/v1
  • Clave de API: enviada como Authorization: Bearer <key>, que n8n hace por ti
  • ID de modelo: uncensored

El servicio es una API LLM alojada y solo de texto que sigue el formato de solicitud de OpenAI para /v1/chat/completions, /v1/responses y /v1/models. No es la API oficial de ningún proveedor de modelos, por lo que cualquier cosa que n8n envíe al endpoint de chat de OpenAI funciona aquí siempre que sea una solicitud de texto.

Paso 1: Crea la credencial

En n8n abre Credenciales, elige Crear credencial y busca OpenAI API. Rellénala así:

  1. Pega tu clave en el campo Clave de API.
  2. Deja vacío el campo ID de organización.
  3. Reemplaza la URL base predeterminada por https://api.onekeyllmapi.com/v1. Mantén el /v1 al final y no añadas /chat/completions.
  4. Guarda. n8n realiza una pequeña llamada de prueba al guardar; si falla, salta a la sección de solución de problemas más abajo.

Mantén una credencial por entorno. Si ejecutas un n8n de staging y uno de producción, dale a cada uno su propia clave para que puedas ver el gasto por separado y revocar una sin tocar la otra.

Paso 2: Construye un flujo de chat simple

Empieza con lo más pequeño que pruebe la conexión: un activador manual y una llamada de modelo.

  1. Añade un nodo Activación manual.
  2. Añade un nodo OpenAI (o el subnodo Modelo de chat OpenAI dentro de una cadena LLM básica, según tu versión de n8n) y selecciona la credencial del paso 1.
  3. Para el modelo, busca una forma de introducir un ID manualmente. Las versiones recientes de n8n ofrecen un modo Por ID junto a la lista. Escribe uncensored allí. La lista puede estar vacía o mostrar solo nombres de OpenAI, porque n8n lo filtra por su cuenta.
  4. Añade un prompt como Resume este ticket de soporte en dos frases y ejecuta el nodo.

Si tu versión de n8n insiste en elegir de una lista, usa el enfoque HTTP Request en la siguiente sección. Siempre funciona porque controlas toda la solicitud.

Llamada a la API con el nodo HTTP Request

El nodo Solicitud HTTP es la forma más predecible de llamar a esta API desde n8n, y expone todos los parámetros que acepta la API, incluidos seed, stop, top_p y tools. Configúralo así:

  • Método: POST
  • URL: https://api.onekeyllmapi.com/v1/chat/completions
  • Autenticación: Tipo de credencial genérico con Autenticación de encabezado, nombre Authorization, valor Bearer YOUR_KEY
  • Enviar cuerpo: activado, tipo de contenido JSON

Cuerpo (cambia el campo a Expresión si quieres insertar datos de nodos anteriores):

{
  "model": "uncensored",
  "messages": [
    {"role": "system", "content": "You are a concise assistant."},
    {"role": "user", "content": "Summarize this support ticket in two sentences."}
  ],
  "temperature": 0.4
}

El texto de la respuesta está en choices[0].message.content. En el siguiente nodo puedes referenciarlo con {{ $json.choices[0].message.content }}.

Para probar la misma solicitud fuera de n8n primero, ejecuta esto en una terminal:

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

Si curl funciona y n8n no, el problema está en la configuración del nodo, no en tu clave o saldo.

Modo JSON para flujos que analizan la salida

Los flujos de trabajo se rompen cuando un modelo envuelve datos en prosa amigable. El modo JSON pide a la API que devuelva un objeto JSON válido, que puedes pasar directamente a un nodo Establecer o SI. Añade response_format al cuerpo:

{
  "model": "uncensored",
  "response_format": {"type": "json_object"},
  "messages": [
    {"role": "system", "content": "Reply only with a JSON object with keys sentiment and summary."},
    {"role": "user", "content": "The delivery was late but support fixed it fast."}
  ]
}

Dos hábitos hacen esto fiable. Primero, di la palabra JSON y nombra las claves en el prompt, porque el modo JSON garantiza la sintaxis, no tu esquema. Segundo, la respuesta sigue llegando como una cadena en message.content, así que añade un nodo Código o una expresión con JSON.parse() antes de leer campos. En el nodo OpenAI, el mismo interruptor aparece como una opción Formato de respuesta bajo las opciones del nodo.

Gestión de errores 429 y otros

n8n ejecuta elementos en paralelo, por lo que un lote de 50 filas puede alcanzar los límites rápidamente. Una clave completa permite 8 solicitudes concurrentes y 300 solicitudes por minuto; una clave de prueba permite 2 y 60. Cuando superas el límite, la API responde con HTTP 429 y el código rate_limited (demasiadas por minuto) o concurrency (demasiadas a la vez). En caso de sobrecarga temporal, obtienes 429 con un encabezado Retry-After: 5.

Configuración práctica en n8n:

  • Abre el nodo, ve a Configuración, habilita Reintentar en caso de error, establece Intentos máximos en 3 o 4 y Espera entre intentos en 5000 ms.
  • Coloca un nodo Bucle sobre elementos (tamaño de lote de 4 a 6) antes de la llamada al modelo para que te mantengas por debajo de 8 solicitudes en paralelo.
  • En la configuración del nodo Ajustes, En caso de error puede configurarse para continuar con una salida de error, de modo que una fila incorrecta no detenga la ejecución.

Para una visión más profunda de los dos tipos de límite, lee la documentación de la API. Otros errores son simples: un 401 significa que la clave es incorrecta o que al encabezado le falta la palabra Bearer, y un 404 suele significar que la URL base tiene un error tipográfico o un segmento de ruta extra.

Lista de comprobación de solución de problemas

La mayoría de los fallos provienen de una lista corta de causas. Revísala de arriba a abajo antes de sospechar del servicio.

SíntomaCausa probableSolución
401 al guardar o ejecutarClave incorrecta, o falta Bearer en el encabezadoPega la clave de nuevo; en Autenticación de encabezado, el valor debe empezar con Bearer
404La URL base tiene un error tipográfico o un segmento extraUsa exactamente https://api.onekeyllmapi.com/v1 en las credenciales
Modelo no encontradoEl ID del modelo no está escrito como uncensoredCambia a Por ID o usa el nodo Solicitud HTTP
429 con concurrenciaMás de 8 ejecuciones simultáneas (2 en una clave de prueba)Procesa en lotes con Bucle sobre elementos y añade reintentos
Error de análisis JSON en la siguiente etapaLa respuesta es una cadena o el prompt no nombró las clavesAnaliza con JSON.parse() y describe las claves en el prompt del sistema

Cuando contactes con soporte, incluye el encabezado de respuesta X-Request-Id de la llamada fallida. En n8n puedes ver los encabezados activando Incluir encabezados de respuesta y estado en las opciones del nodo Solicitud HTTP.

Pruebas sin gastar mucho

Usa el crédito de prueba mientras desarrollas. Con 2 peticiones simultáneas y 60 peticiones por minuto, una clave de prueba es lenta para lotes, pero suficiente para comprobar una credencial, un prompt y la lógica de análisis. Cambia a una clave completa cuando muevas el flujo de trabajo a un horario.

Coste y un diseño de flujo de trabajo sensato

La facturación es pago por uso: $0,15 por cada 1M de tokens de entrada y $0,50 por cada 1M de tokens de salida, descontados del crédito prepago. Un flujo de trabajo que clasifica 1.000 correos electrónicos al día, con 600 tokens de entrada y 100 de salida por correo, consume 0.6M de tokens de entrada ($0,09) y 0.1M de tokens de salida ($0,05), un total de aproximadamente $0,14 al día. Las peticiones fallidas o rechazadas no se cobran, por lo que los reintentos por errores no duplican la factura. Los detalles están en la página de precios.

Mantén los prompts cortos, envía solo los campos que el modelo necesita y establece max_tokens cuando sepas que la respuesta será breve. Si también ejecutas modelos en tu propia máquina, consulta el artículo sobre el uso de un LLM local a través de una API estilo OpenAI, que usa la misma configuración del cliente.

Preguntas y respuestas

¿Qué nodos de n8n funcionan con una URL base personalizada?

Cualquier nodo que use la credencial de OpenAI puede usarla, porque el campo URL base pertenece a la credencial. Si un nodo no expone un parámetro que necesites, usa el nodo Solicitud HTTP.

¿Por qué la lista de modelos está vacía o es incorrecta en n8n?

n8n carga y filtra la lista por su parte. Introduce el ID del modelo uncensored a mano, o usa el nodo HTTP Request donde el modelo es solo un campo en el cuerpo.

¿Puedo usar streaming en n8n?

La API admite streaming sobre SSE, pero la mayoría de los nodos de n8n esperan la respuesta completa antes de pasar los datos. Para flujos de trabajo, una llamada normal sin streaming es más sencilla.

¿Cómo verifico mi saldo desde un flujo de trabajo?

Llama a GET /v1/balance o lee la cabecera X-Balance-USD en cualquier respuesta y añade un nodo SI que te alerte cuando baje de un umbral.

Tu clave está a un formulario de distancia

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