Usar ORYKSA como la IA de tus automatizaciones en n8n
Donde un flujo pide OpenAI u OpenRouter, usa ORYKSA. El consumo sale de las interacciones de tu plan.
Para qué sirve
Las automatizaciones en n8n necesitan muchas veces un modelo de IA: para escribir una publicación a partir de un vídeo nuevo en YouTube, para clasificar una fila nueva en Google Sheets, para resumir un archivo de Google Drive. Normalmente pagarías a OpenAI u OpenRouter por eso. Con ORYKSA no los necesitas: ORYKSA es el modelo y usa las interacciones de tu plan.
Tu n8n sigue hablando con YouTube, Instagram, LinkedIn, Drive o Sheets con tus cuentas. ORYKSA solo piensa y escribe.
Lo que necesitas
- Una cuenta ORYKSA.
- Una clave de API. Créala en developer.oryksa.com. Empieza por oryk_live_. Guárdala en privado, como una contraseña.
Configurarlo en n8n
- En n8n, abre Credentials y crea una credencial nueva de tipo OpenAI.
- En API Key, pega tu clave ORYKSA.
- En Base URL, escribe https://api.oryksa.com/v1
- Guarda. n8n prueba la conexión por sí solo.
- En tu flujo, donde haya un OpenAI Chat Model (en un AI Agent, un Basic LLM Chain, un Information Extractor, un Text Classifier), elige esta credencial y el modelo oryksa.
- La opción Use Responses API puede estar activada o desactivada: ORYKSA responde en los dos formatos.
Un flujo que importaste y que dice gpt-4o u otro nombre de modelo también funciona: ORYKSA responde en su lugar.
En Make, Zapier y otras herramientas la idea es la misma: donde la herramienta pide la dirección y la clave de OpenAI, usa la dirección de ORYKSA y tu clave ORYKSA.
Dos modelos
- oryksa: el modelo general. Hace lo que tu flujo le dice y no sabe nada de tu cuenta. Usa este en las automatizaciones.
- oryksa-assistant: tu propio asistente ORYKSA, con el conocimiento y los datos de tu negocio. Solo responde.
Lo que gasta
Cada respuesta del modelo gasta una interacción de tu plan. Un AI Agent que llama a herramientas recibe varias respuestas seguidas, así que gasta una interacción por cada una. Cuando se acaban las interacciones, el flujo recibe un error que lo dice. No se cobra nada más allá de tu plan.
Límites
Cada petición puede llevar hasta 32 000 caracteres de texto y cada respuesta hasta 2 000 tokens. Para un documento largo, divídelo en partes en tu flujo.
Si algo no funciona
- Clave no válida: comprueba que pegaste la clave entera y que no fue revocada.
- El modelo no aparece: comprueba el Base URL. Tiene que terminar en /v1.
- Error con "Use Responses API" activado: ORYKSA acepta texto, herramientas de función, salida en JSON y streaming en ese formato. No acepta las herramientas propias de OpenAI (búsqueda web, búsqueda en archivos, intérprete de código) ni conversaciones guardadas (
previous_response_id): envía la conversación entera en cada petición. El mensaje de error indica el campo. - Petición demasiado grande: el texto pasa de 32 000 caracteres. Envía menos cada vez.
- Límite alcanzado: tu plan no tiene más interacciones en este periodo.
Centro de Ayuda