Guías
n8n
Usa tu stack como el modelo de lenguaje detrás de cualquier nodo de IA de n8n, con el paquete comunitario n8n-nodes-stac.
n8n-nodes-stac es un paquete
de nodo comunitario que añade el sub-nodo Stac Chat Model a n8n. Se conecta
a la entrada Model de cualquier nodo raíz de IA — AI Agent, Basic LLM Chain,
Question and Answer Chain — para que el workflow corra en tu stack en lugar de
un proveedor cobrado por token.
El nodo habla con la misma superficie compatible con OpenAI que todo lo demás aquí, así que nada cambia en tu stack: la misma clave, la misma base URL, el mismo precio fijo mensual por más que el workflow se dispare.
Instala el nodo
Abre Settings → Community nodes
Necesitas ser el owner de la instancia. Consulta la guía de instalación de n8n si la sección no aparece.
Instala n8n-nodes-stac
Haz clic en Install a community node, escribe el nombre del paquete, acepta el aviso de riesgos e instala. n8n recarga el registro de nodos por su cuenta — no hace falta reiniciar el contenedor.
O instálalo manualmente
En una instancia self-hosted puedes saltarte la interfaz e instalar directamente en el directorio de nodos personalizados de n8n:
bashcd ~/.n8n/nodes npm install n8n-nodes-stacReinicia n8n después.
Crea la credencial
El paquete trae un tipo de credencial, Stac API, compartido por todos sus nodos.
| Campo | Valor |
|---|---|
| API Key | Una clave de la página API keys de tu stack. n8n la guarda cifrada y no la vuelve a mostrar después de guardar |
| Base URL | https://api.trystac.com/v1 — déjala así, salvo que te hayan dado un endpoint dedicado |
La autenticación es por bearer token (Authorization: Bearer <clave>), igual
que en cualquier otro cliente de Stac. El botón Test de la credencial llama
a GET /v1/models, así que una prueba en verde
confirma la clave y la base URL de una sola vez.
Las claves están limitadas a un único stack. Usa una clave aparte para n8n en vez de reutilizar la de tu aplicación — así revocarla no tumba tu producto con ella. Consulta Autenticación.
Añádelo a un workflow
Añade un nodo raíz de IA
Un AI Agent es el punto de partida habitual, pero sirve cualquier nodo con entrada
Model.Conecta Stac Chat Model a su entrada Model
Busca "Stac" en el panel de nodos — aparece en Language Models → Chat Models.
Elige el modelo
El desplegable Model se rellena al editar desde
GET /v1/models, así que lista exactamente lo que tu clave puede llamar — en la mayoría de los planes, una sola entrada: el modelo que corre tu stack.
Parámetros
Todo excepto Model vive en Options y es opcional.
| Parámetro | Valor por defecto | Notas |
|---|---|---|
| Model | — | Obligatorio. Se carga de tu plan; también acepta una expresión |
| Sampling Temperature | 0.7 | 0–2. Cuanto más bajo, más determinista |
| Maximum Number of Tokens | 2048 | Límite de tokens generados. La API aplica su propio piso y techo — consulta Chat completions |
| Timeout | 120000 | En milisegundos. Bajo saturación Stac degrada la velocidad en lugar de fallar, así que un timeout ajustado corta respuestas que sí habrían llegado |
| Max Retries | 2 | Reintentos por petición fallida |
Cómo encaja en n8n
El nodo construye el modelo con supplyModel de @n8n/ai-node-sdk, que n8n
provee en runtime. Dos consecuencias que conviene conocer:
- Sin LangChain empaquetado.
n8n-workflowy@n8n/ai-node-sdkson peer dependencies, así que el proceso mantiene una única instancia de@langchain/coreen lugar de dos peleándose. - Las ejecuciones las traza n8n mismo. Las llamadas al modelo aparecen en la vista de logs y tracing de n8n, con prompts y recuento de tokens, no solo como una llamada HTTP opaca.
Desarrollado y probado con n8n 2.36.9. Las versiones anteriores traen releases previas de ese SDK y no se han probado.
Solución de problemas
- El desplegable de Model está vacío. La credencial no puede alcanzar
GET {baseUrl}/models— clave incorrecta, base URL incorrecta, o la instancia sin salida a red. Ejecuta la prueba de la credencial para saber cuál. 401 invalid_api_key. La clave fue revocada o pertenece a un stack eliminado. Genera una nueva; consulta Errores.429en un workflow con mucho tráfico. Los límites de uso son por clave. Dale a n8n su propia clave para que una tormenta de reintentos en el workflow no limite tu aplicación.- El nodo no aparece tras instalarlo. Comprueba que
N8N_COMMUNITY_PACKAGES_ENABLEDno esté enfalsey recarga el editor.
Recursos
Próximos pasos
- Compatibilidad OpenAI — la superficie que habla el nodo y qué difiere de OpenAI.
- Autenticación — formato de la clave, alcance, rotación.
- Base de conocimientos — fundamenta las respuestas del workflow en tus documentos, sin ningún nodo de búsqueda en el canvas.