Description

@j2i/n8n-nodes-j2i

n8n community node for jsontoimg. Render templates to PNG, JPG, WebP, AVIF, or PDF from n8n workflows.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Usage
Resources

Installation

Follow the installation guide in the n8n community nodes documentation.

Package name: @j2i/n8n-nodes-j2i

Operations

• Template

– Get many templates
– Get template schema

• Render

– Create a render (optional wait)
– Wait for a render
– Get a render
– Get a render asset URL
– Download a render asset (binary)

• Batch

– Create a batch (up to 50 jobs)
– Get a batch

• Signed Image

– Sign an image URL
– Sign many image URLs
– Download a signed image (binary; no API key on the GET; retries 503)

Credentials

Use a jsontoimg API key.

1. Create a key under Integrations → API keys.
2. In n8n, add jsontoimg API credentials.
3. Paste the key. Leave Base URL as https://app.jsontoimg.com unless you self-host.

Requests send Authorization: Bearer to /api/v1. Signed image downloads do not send the key.

Compatibility

Compatible with n8n@1.60.0 or later.

Usage

End-to-end: Render → Create a PNG and wait for the signed assetUrl.

1. Install the node and add jsontoimg API credentials (see Credentials).
2. Add a jsontoimg node.
3. Set Resource to Render and Operation to Create.
4. Pick a Template from the list (or paste a template ID). Template is this field, not the Payload JSON.
5. Put format, layers, and wait in Payload:

{
  "format": "png",
  "wait": 60,
  "layers": {
    "headline": { "text": "{{ $json.title }}" },
    "photo": { "image_url": "{{ $json.imageUrl }}" }
  }
}

Layer names must match the design. Use Template → Get Schema first if you are unsure.

Expected output when wait is set and the job finishes:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "done",
  "format": "png",
  "attempts": 1,
  "error": null,
  "assetUrl": "https://app.jsontoimg.com/api/v1/renders/550e8400-e29b-41d4-a716-446655440000/asset?sig=…"
}

assetUrl includes ?sig= so it works in with no API key. Use Download Asset with the render id when the next node needs binary (Gmail, Drive, Slack).

Without wait, Create queues the job (status: "queued"). Follow with Wait, Get, or a webhook.

Resources

• n8n community nodes documentation
• jsontoimg n8n docs
• jsontoimg API reference