Genera imágenes en n8n con HTTP Request.

Empieza con un título y una plantilla.

Necesitas una plantilla guardada en Pikstrapi, su UUID, una API key de la misma cuenta y acceso a un flujo de n8n. Nombra title a la capa de texto. Esta guía no requiere un conector nativo de Pikstrapi.

Para la primera prueba, conecta Manual Trigger a Edit Fields (Set). Añade un campo de texto llamado title con un titular de ejemplo. La entrada que llegue a HTTP Request debe tener esta forma:

{
  "title": "Nuevo artículo. Listo para compartir."
}

Después, sustituye este ejemplo por una fila de tu hoja de cálculo o un evento de tu CMS. Primero comprueba que existe el campo title y contiene texto.

Revisar petición y respuesta de API de imágenes

Configura HTTP Request para Pikstrapi.

Añade HTTP Request después del nodo de entrada. Configura Method como POST y URL con el endpoint del API playground de tu cuenta. Si aparece el ejemplo siguiente, sustituye YOUR_API_BASE_URL por la URL base que incluye /api/v1.

POST https://api.pikstrapi.com/api/v1/templates/generate-image

1. Authentication: elige Generic Credential Type → Header Auth. Crea una credencial con Name x-api-key y Value tu API key de Pikstrapi.
2. Send Body: actívalo, configura Body Content Type como JSON y Specify Body como Using JSON.
3. Cambia el campo JSON a Expression. Pega esta expresión, sustituye YOUR_TEMPLATE_ID y revisa la vista previa antes de ejecutar.

{{ JSON.stringify({
  templateId: "YOUR_TEMPLATE_ID",
  exportFormat: "png",
  mode: "immediate",
  layers: { title: { text: $json.title } }
}) }}

JSON.stringify serializa todo el cuerpo, incluidas comillas y saltos de línea del título. No construyas JSON insertando un título entre comillas. La capa title debe coincidir con el nombre guardado en tu plantilla.

Recibe un archivo y envíalo al siguiente paso.

En Options → Response, configura Response Format como File y Put Output in Field como data. Ejecuta un elemento. La respuesta inmediata PNG es binaria: no elijas JSON como formato de respuesta.

Revisa la salida binaria y previsualiza la imagen. El siguiente nodo de subida, almacenamiento o mensajería debe leer la propiedad binaria data. Que ese destino acepte archivo o URL depende de su propia API.

Prueba otro titular con comillas o tildes. Cuando ambas imágenes sean correctas, sustituye la entrada manual por tu disparador real y mapea su campo de título.

Usa webhook para separar generación y entrega.

Para generación diferida, cambia mode a deferred y el formato de respuesta de HTTP Request a JSON. La respuesta inicial contiene jobId, status, progress y fileId; confirma que el trabajo se ha aceptado, pero no que la imagen esté terminada.

Crea un flujo receptor con un nodo Webhook POST y copia su URL de producción. Publica o activa el flujo según tu versión de n8n para recibir peticiones. Un webhook de prueba solo escucha mientras pruebas; usa URL de producción para entrega continua.

{
  "templateId": "YOUR_TEMPLATE_ID",
  "exportFormat": "png",
  "mode": "deferred",
  "layers": {
    "title": {
      "text": "Mi próximo artículo"
    }
  },
  "webhookUrl": "YOUR_N8N_PRODUCTION_WEBHOOK_URL",
  "metadata": {
    "sourceId": "YOUR_SOURCE_RECORD_ID"
  }
}

Sustituye todos los valores de ejemplo. La URL receptora debe ser accesible desde Pikstrapi por HTTP(S); localhost y las direcciones de red privada no sirven. Metadata puede llevar el ID del registro de origen para asociar el resultado.

• render.completed: data contiene jobId y, cuando están disponibles, fileUrl y fileId. En el nodo Webhook de n8n revisa body.event y body.data del elemento recibido.
• render.failed: procesa el error por separado y conserva el registro de origen para revisarlo. La aceptación inicial no confirma el éxito.

La entrega puede repetirse. Evita acciones duplicadas mediante jobId y event, y confirma recepción sin demoras. Para archivos privados usa los requisitos de acceso de tu cuenta; no supongas que fileUrl es pública.

Nodo Pikstrapi: consulta su estado de publicación.

El nodo comunitario de Pikstrapi está preparado como candidato de desarrollo local. Incluye render inmediato, trabajos diferidos, consulta de estado, cancelación de trabajos encolados y combinación de PDFs completados. En la revisión del 9 de octubre de 2026, n8n-nodes-pikstrapi no está publicado en el registro público de npm y no hay una ficha verificada de n8n confirmada.

Los pasos anteriores usan los nodos HTTP Request integrados en n8n y el contrato público de la API. Puedes seguir esta guía sin un paquete comunitario. Antes de instalar un futuro nodo Pikstrapi, confirma su publicación, las instrucciones de instalación y la compatibilidad con tu entorno n8n.

Para salida PDF inmediata con HTTP Request, elige exportFormat: pdf y Response Format: File. Para combinar páginas, sigue la guía de PDF: genera páginas individuales como trabajos PDF diferidos, espera a que terminen y envía sus IDs al endpoint de combinación.

Guía API de generación y combinación PDF

Si falla el flujo, revisa la conexión y los datos.

• Error de autenticación. Revisa Header Auth, x-api-key y cuenta propietaria de la plantilla. No incluyas la key en flujos compartidos.
• Texto sin cambios. Revisa title entrante y nombre exacto de capa guardada. Prueba un elemento antes de añadir más fuentes.
• Error al interpretar JSON. Usa expresión de cuerpo completo y comprueba su valor en vista previa. Salida immediate debe ser File; salida deferred debe ser JSON.
• Webhook sin recibir. Revisa URL de producción, estado del flujo receptor y accesibilidad pública. Consulta estado del trabajo antes de solicitar otro render.

Conecta tu flujo real de publicación.

Usa un artículo nuevo para una portada, un curso completado para un certificado o una fila de datos para un banner. La plantilla define el diseño; tu flujo aporta los datos y decide dónde entregar el resultado.

• Guía API de generación de imágenes Pikstrapi
• Preparar plantilla de certificado y CSV de participantes
• Guías y archivos de ejemplo de Pikstrapi
• API playground de tu cuenta
• n8n: referencia HTTP Request
• n8n: referencia Webhook y URLs prueba/producción

Guía de configuración de Pikstrapi, revisada con el contrato de la API y la documentación de n8n el 9 de octubre de 2026. Usa tus credenciales y comprueba los pasos en tu versión de n8n.