n8n

El campo Base URL de la credencial OpenAI — https://api.kunavo.com/v1, conservando /v1 — coloca todos los OpenAI Chat Model de un flujo de trabajo de n8n en Kunavo; el propio nodo del modelo no tiene campo de endpoint.

Credentials  →  Create credential  →  OpenAI
  API Key                      sk-kn-...
  Organization ID (optional)   leave empty
  Base URL                     https://api.kunavo.com/v1     <- keep the /v1

Workflow  →  AI Agent or Basic LLM Chain  →  Chat Model: OpenAI Chat Model
  Credential to connect with   the OpenAI credential above
  Model                        ID mode:  claude-sonnet-5
  Use Responses API            on   → POST /v1/responses
                               off  → POST /v1/chat/completions

Paso a paso

1. Cree una clave en /app/keys y cópiela: se muestra una sola vez.
2. En n8n, crea una credencial de tipo OpenAI. Introduce la clave en API Key, deja vacío Organization ID (optional) y sustituye el valor predeterminado https://api.openai.com/v1 de Base URL por https://api.kunavo.com/v1. Guarda.
3. Añade un nodo AI Agent o Basic LLM Chain y conecta un subnodo OpenAI Chat Model que use esa credencial. Cambia el campo Model de From List a ID y escribe el ID tal como aparece en GET /v1/models, por ejemplo claude-sonnet-5. También puedes usar la lista, pero escribir el ID hace que el flujo de trabajo sea más legible.
4. Decide si activar Use Responses API: déjalo activado salvo que una herramienta de tu cadena espere Chat Completions o quieras que el registro de ejecución de n8n muestre una solicitud de chat completions.
5. Ejecuta el flujo de trabajo una vez con una indicación de una sola línea antes de conectarlo a un desencadenador. Un 401 indica un problema con la clave; un 404 con el código missing_v1_prefix (o, en ejecuciones antiguas, un mensaje que empieza por <!DOCTYPE html>) indica que falta /v1 en Base URL.

Comprobado con Código fuente de la credencial OpenAI de n8n en la etiqueta n8n@2.41.4 el 1 de octubre de 2026. La configuración de terceros puede cambiar; si el nombre de un campo ya no coincide con lo que ves, esa página es la autoridad, no esta.

Verifica antes de depurar el cliente

Una solicitud determina si el fallo está en el endpoint, la clave o el archivo de configuración. Si devuelve JSON, la misma URL base y la misma clave funcionan en n8n.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Qué ID de modelo introducir en el campo

Todos los modelos de texto están disponibles mediante un ID de modelo; la lista activa está en GET /v1/models, y el catálogo con precios está en la página de modelos. Las tarifas son USD por 1M de tokens, entrada / salida.

Por qué Base URL está en la credencial

Los tutoriales antiguos configuran el endpoint dentro del nodo de modelo. En el código publicado, esa opción Base URL dentro del nodo está oculta desde la versión 1.1 del nodo, así que un nodo que añadas hoy no tendrá ese campo y se usará Base URL de la credencial. La propia documentación de OpenAI Chat Model de n8n y su página de credenciales no describen este campo; el código fuente sí, con la descripción «Override the default base URL for the API». El nodo HTTP Request es una vía completamente distinta: funciona, pero tendrías que construir a mano la solicitud que un nodo AI Agent prepara por ti.

Responses API activada o desactivada

• Activada (valor predeterminado en el nodo 1.3): las solicitudes van a /v1/responses. Este es el único modo que muestra las herramientas integradas del nodo: Web Search, File Search y Code Interpreter. Son herramientas alojadas por OpenAI; nadie las ha probado a través de Kunavo, así que no crees un flujo de trabajo que dependa de ellas sin probarlo primero.
• Desactivada: las solicitudes van a /v1/chat/completions, el formato con mayor compatibilidad y al que conviene recurrir si una llamada a herramienta se comporta de forma inesperada con la otra opción.
• Las herramientas que conectas a un AI Agent se envían al modelo como definiciones de funciones. Esa interacción de ida y vuelta no formó parte de esta comprobación, así que ejecuta una llamada a herramienta en un flujo de prueba antes de confiar en ella.

n8n y OpenRouter

n8n incluye un nodo OpenRouter Chat Model independiente con su propia credencial OpenRouter. Esa credencial tiene un campo API Key y un campo Base URL oculto y fijado en https://openrouter.ai/api/v1; además, su prueba llama a la ruta /key propia de OpenRouter. Por tanto, el nodo OpenRouter solo puede comunicarse con OpenRouter. Si quieres usar OpenRouter, emplea ese nodo con una clave de OpenRouter; no necesitas nada de esta página.

Cualquier otro endpoint compatible con OpenAI, incluido Kunavo, se configura como se indica arriba mediante OpenAI Chat Model y el campo Base URL de la credencial OpenAI. Elige entre ellos según las diferencias reales: qué modelos necesitas, cómo quieres pagar y si quieres usar un saldo común para n8n y tus otras herramientas. La comparación desde el punto de vista de Kunavo está en Kunavo frente a OpenRouter.

Cómo limitar el coste de un flujo de trabajo sin supervisión

• El valor predeterminado de Max Retries es 2 y el de Timeout, 60000 ms. Si una solicitud agota el tiempo de espera, se vuelve a intentar, y cada reintento es una nueva solicitud facturable.
• Configura Maximum Number of Tokens en los nodos que se ejecutan por elemento: un bucle de 1,000 filas multiplica el coste de una sola llamada.
• Usa una clave de Kunavo distinta para cada flujo de trabajo de producción para que la página de uso muestre cuál generó cada gasto y puedas revocar una sin afectar las demás.

Cómo son los errores

• “401 Missing or invalid API key”: Base URL es correcta, pero la clave no. Reproducido en la versión 2.41.4.
• “404 <!DOCTYPE html>…”, clasificado por LangChain como MODEL_NOT_FOUND. Es engañoso: el modelo está bien; a Base URL le falta /v1 y la solicitud llegó al sitio web. Reproducido en la versión 2.41.4.
• Un mensaje JSON de modelo no disponible: el ID del modelo no coincide exactamente con GET /v1/models.