n8n en Rusia: flujos de trabajo con IA, errores y costes
Conecta BetterToken a n8n, ejecuta un flujo de IA, limita los reintentos y concilia cada ejecución con los tokens y cargos en el Dashboard.
¿Quieres probar un flujo de IA en n8n con una única solicitud controlada? Abre la guía de n8n de BetterToken, crea tu propia API Key y añade una credencial de OpenAI en n8n. Conecta Manual Trigger, AI Agent y OpenAI Chat Model, limita Max Retries y compara la ejecución manual con su modelo, estado, uso de tokens y cargo en el BetterToken Dashboard.
Qué hace n8n en este proceso de IA
n8n gestiona la secuencia de nodos y guarda los datos de ejecución. OpenAI Chat Model envía una solicitud al modelo elegido y BetterToken recibe una llamada de API compatible con OpenAI. Para la primera prueba bastan tres componentes:
Manual Trigger evita que se inicie una ejecución accidental desde una programación o un webhook. AI Agent recibe un prompt fijo y Chat Model envía una sola solicitud al modelo. No añadas Telegram, correo electrónico, base de datos, publicación ni ningún otro nodo con efectos externos.
En este esquema, BetterToken proporciona la API Key, la Base URL, el Model ID disponible y el registro de uso en el Dashboard. No garantiza la compatibilidad de todos los nodos de la comunidad ni de las herramientas alojadas por OpenAI. Conectarse al BetterToken API Endpoint desde Rusia no requiere VPN; la disponibilidad de n8n Cloud, tu servidor y las integraciones de terceros debe comprobarse por separado.
Crear una credencial sin exponer la API Key
- Añade el nodo AI Agent al flujo de trabajo.
- En el conector Chat Model, añade el subnodo OpenAI Chat Model.
- En el campo Credential to connect with, elige Create new credential → OpenAI.
- Si la interfaz muestra OpenAI Account (ChatGPT) y API Key, selecciona API Key.
Completa la credencial:
- API Key: tu API Key de BetterToken.
- Organization ID: déjalo vacío.
- Base URL:
https://www.bettertoken.ai/v1. - Add Custom Header: desactívalo.
Guarda la credencial en el almacenamiento seguro de n8n. No insertes la clave en un prompt, JSON del flujo, Code node, captura de pantalla, datos de ejecución ni repositorio.
Consulta la documentación oficial de n8n sobre credenciales OpenAI para los campos y modos de autorización actuales.
La Base URL debe terminar en /v1. No añadas /models, /chat/completions ni /responses: n8n completa la dirección por sí mismo. Al guardar una credencial, n8n consulta los modelos mediante /models respecto a la Base URL indicada.
Si no aparece la lista de modelos, vuelve a abrir la credencial y OpenAI Chat Model. Obtén el Model ID exacto de la documentación actual de BetterToken para n8n o del catálogo de modelos; este artículo no fija un ID dinámico.
Montar un flujo de IA mínimo
1. Añadir Manual Trigger
Crea un flujo de trabajo nuevo y añade Manual Trigger. No publiques el flujo mientras haces la prueba: n8n recomienda las ejecuciones manuales durante el desarrollo y las pruebas.
2. Configurar AI Agent
Conecta Manual Trigger a AI Agent. En las opciones del prompt, selecciona una entrada que te permita indicar texto fijo y usa:
No conectes Tool nodes. Esta prueba necesita una respuesta del modelo, no automatización del agente.
3. Conectar OpenAI Chat Model
En el subnodo OpenAI Chat Model:
- selecciona la credencial de BetterToken creada;
- selecciona el Model ID exacto;
- para la primera solicitud, desactiva Use Responses API y usa Chat Completions;
- establece un Timeout final;
- configura Max Retries con el valor mínimo que permita la versión actual de n8n.
Los parámetros Model, Use Responses API, Timeout y Max Retries se describen en la página oficial de OpenAI Chat Model.
Responses API y las funciones integradas Web Search, File Search o Code Interpreter no forman parte de esta prueba. Que aparezcan en la interfaz de n8n no confirma que el modelo o endpoint seleccionados las admitan.
4. Ejecutar exactamente una prueba manual
Haz clic en Execute Workflow. Un resultado correcto debe contener JSON con workflow: "n8n" y sum: 4. Si un nodo devuelve un error, no reinicies inmediatamente: primero clasifica el error.
Dónde consultar el registro de ejecución
Abre Executions para el flujo actual y selecciona la ejecución manual. Comprueba:
- el estado general de la ejecución;
- la hora de inicio y la duración;
- la entrada y salida de AI Agent;
- el nodo donde se detuvo el proceso;
- el texto del error sin copiar la credencial ni un prompt sensible.
n8n distingue entre ejecuciones manuales y de producción. La ejecución manual se inicia desde el editor y sirve para probar; la de producción comienza automáticamente tras publicar un flujo o desde un trigger. Deja el flujo sin publicar hasta verificar el provider.
Las diferencias entre tipos de ejecución y listas de ejecuciones están documentadas en la documentación de ejecuciones de n8n.
Los datos de ejecución pueden contener la entrada y salida de un nodo. Para flujos sensibles, n8n admite redaction, que oculta los datos y conserva metadatos como estado, hora y nombres de nodos. El prompt de esta instrucción no contiene datos personales ni secretos.
Limitar reintentos y diagnosticar el error
El reintento automático solo sirve para errores temporales. También crea solicitudes de API adicionales, de modo que afecta al coste y complica la correspondencia con una sola ejecución.
401/ Unauthorized: no repitas automáticamente; primero comprueba la API Key y los espacios de más.403: no repitas automáticamente; comprueba el acceso de la clave al modelo elegido.404/ model not found: no repitas automáticamente; comprueba la Base URL y el Model ID exacto.429: permite solo una repetición limitada tras una pausa; comprueba el límite de tasa y el número de ejecuciones paralelas.5xx/ timeout: no superes el límite definido; comprueba el estado del provider, Timeout y el tamaño del prompt.- Workflow error: no repitas antes del diagnóstico; comprueba el nodo, la expresión y los datos de entrada.
En la primera prueba, mantén Max Retries al mínimo y no añadas un bucle, Wait + retry ni un error workflow con una llamada nueva a la API. Si más tarde necesitas reintentos en producción, define un número finito de intentos y una demora, y después comprueba cuántas solicitudes aparecieron en el Dashboard.
Un n8n error workflow sirve para notificar fallos, pero la propia notificación es un efecto externo. Añádelo solo después de una comprobación separada y con tus propios límites.
El mecanismo Error Trigger y los datos de una ejecución fallida se describen en el manual oficial de manejo de errores.
Comprobar tokens y coste en el Dashboard
Abre el BetterToken Dashboard inmediatamente después de una ejecución manual. Compara:
- la hora de inicio acotada en n8n con la hora de la solicitud en el Dashboard;
- el Model ID de OpenAI Chat Model con el modelo del registro de uso;
- el estado de éxito o error;
- los tokens de entrada, salida y caché que correspondan;
- el cargo asociado a ese registro.
No calcules el importe a partir de un artículo antiguo ni de una cifra fija por millón de tokens. El modelo y el precio cambian: toma el cargo real de una llamada del Dashboard y las tarifas actuales de la página de precios de BetterToken.
Si una ejecución manual coincide con varias líneas del Dashboard, revisa Max Retries y el comportamiento del agente. Una ejecución de workflow visible puede causar varias solicitudes al modelo, sobre todo con un bucle de agente o herramientas de Responses. Por eso la primera comprobación usa un prompt fijo, sin herramientas y con el mínimo de repeticiones.
Errores frecuentes
La prueba de la credencial devuelve 401
Vuelve a crear la credencial de tipo OpenAI, elimina los espacios alrededor de la API Key y confirma que está seleccionado el modo API Key, no OpenAI Account. No muestres la clave en el registro de ejecución.
La prueba de la credencial o un nodo devuelve 404
La Base URL debe ser https://www.bettertoken.ai/v1. No añadas /models ni un endpoint. Después recarga la lista de modelos y selecciona el ID actual.
El chat normal funciona, pero las herramientas del agente no
Vuelve al flujo mínimo: desactiva Use Responses API, elimina Tool nodes y repite un prompt fijo. Así separas la conexión con el provider de la restricción concreta de una herramienta o del flujo.
La ejecución se completa, pero el Dashboard muestra varias solicitudes
Comprueba Max Retries y el bucle del agente. Compara horas y estados. No sumes manualmente las líneas como una llamada si n8n envió realmente varias solicitudes.
Preguntas frecuentes
¿Tengo que publicar un flujo para revisarlo?
No. Basta una ejecución manual desde el editor. Publicar activa triggers de producción y puede iniciar acciones externas sin confirmación adicional.
¿Puedo usar la Responses API?
Solo después de verificar por separado el modelo y endpoint elegidos. Para la primera conexión, usa Chat Completions normal sin herramientas OpenAI integradas.
¿Dónde se guarda la API Key de BetterToken?
En la credencial de tipo OpenAI de n8n. No la dupliques en parámetros de nodos, JSON del flujo, prompt ni repositorio.
¿Cómo conozco el coste real de un flujo?
Ejecuta una prueba manual con el mínimo de retries y compara hora de ejecución, Model ID y estado con la entrada del BetterToken Dashboard. Toma los tokens y el consumo de ese registro, no de un ejemplo estimado.