Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (n8n-nodes-gemini-nano-banana-pro) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

n8n-wordpress-nano-banana

npm version npm downloads license

Generate images using Google Gemini API in your n8n workflows. Perfect for automatically creating WordPress featured images from post titles.

n8n is a fair-code licensed workflow automation platform.

✨ Features

🎨 Generate images using Google Gemini API
🔄 Dynamic prompt templating with {{input}} placeholder
📐 Customizable aspect ratios (16:9, 9:16, 4:3, 3:4, 1:1)
📏 Multiple image sizes (1K, 2K, 4K)
📤 Output as binary (for upload), base64, or JSON
🌐 Perfect for WordPress featured image automation
🇻🇳 Full Vietnamese documentation available

📦 Installation

From n8n (Recommended)

Open n8n
Go to Settings → Community Nodes
Click Install
Enter: n8n-wordpress-nano-banana
Click Install
Restart n8n (if required)

From npm

For self-hosted n8n:

cd ~/.n8n
npm install n8n-wordpress-nano-banana
# Restart n8n

For Development

git clone https://github.com/tamtinhte365/n8n-wordpress-nano-banana.git
cd n8n-wordpress-nano-banana
npm install
npm run build
npm link

🚀 Quick Start

1. Get Gemini API Key

Visit Google AI Studio to get your free API key.

2. Add Credentials in n8n

Go to Credentials → New
Search for "Gemini API"
Enter your API key
Click Save

3. Use the Node

Search for "Gemini Image Generator" in the node palette and add it to your workflow.

🎯 Use Case: WordPress Featured Images

Automatically generate and set featured images for WordPress posts based on their titles.

Workflow Structure

WordPress (Update Post)
  ↓ [outputs: title, id, ...]
Gemini Image Generator
  ↓ [outputs: binary image]
HTTP Request (Upload to WordPress)
  ↓ [outputs: media ID]
WordPress (Set Featured Image)

Step-by-Step Setup

1. WordPress Node - Update Post

Resource: Post
Operation: Update
Post ID: Your post ID
Update your post content as needed

Output includes: title, id, status, etc.

2. Gemini Image Generator Node

Configure the node:

Model: gemini-3-pro-image-preview
Prompt Source: From Input Field
Input Field Name: title

Prompt Template:

Tạo ảnh đại diện cho bài viết về chủ đề: "{{input}}"
Yêu cầu: KHÔNG chèn chữ, chỉ là ảnh để làm nổi bật ý nghĩa của tiêu đề trên.

Aspect Ratio: 16:9
Image Size: 1K
Output Format: Binary (for upload)
Binary Property Name: data

3. HTTP Request Node - Upload to WordPress

Method: POST
URL: https://your-site.com/wp-json/wp/v2/media
Authentication: Basic Auth or WordPress API
Send Binary Data: Yes
Binary Property: data

Headers:

Content-Disposition: attachment; filename="featured-{{ $now.toFormat("yyyyMMddHHmmss") }}.png"

4. WordPress Node - Set Featured Image

Resource: Post
Operation: Update
Post ID: {{ $('WordPress').item.json.id }}
Additional Fields → Featured Media: {{ $json.id }}

📝 Node Parameters

Model

Choose the Gemini model:

gemini-3-pro-image-preview - Latest image generation model
gemini-2.0-flash-exp - Experimental faster model

Prompt Source

From Input Field: Use data from previous node (recommended for dynamic content)
Custom Prompt: Enter a static prompt

Input Field Name

The field name to extract from previous node data. Examples:

title - WordPress post title
name - Product name
description - Any description field

Prompt Template

Use {{input}} as placeholder for the input field value.

Example (Vietnamese):

Tạo ảnh đại diện cho bài viết về chủ đề: "{{input}}"
Yêu cầu: KHÔNG chèn chữ, chỉ là ảnh để làm nổi bật ý nghĩa của tiêu đề trên.

Example (English):

Create a professional featured image for a blog post about: "{{input}}"
Requirements:
- Modern, minimalist style
- No text overlay
- Vibrant colors
- Suitable for technology/business blog

Aspect Ratio

16:9 - Wide (recommended for blog headers)
9:16 - Tall (for social media stories)
4:3 - Standard
3:4 - Portrait
1:1 - Square (for social media posts)

Image Size

1K (1024px) - Fast generation, suitable for most uses
2K (2048px) - Medium quality
4K (4096px) - High quality, slower generation

Output Format

Binary (for upload) - Ready to upload to WordPress, cloud storage, etc.
Base64 - Text representation of the image
JSON Response - Full API response for debugging

🌟 Example Workflows

Blog Post Automation

RSS Trigger (New Article)
  → WordPress (Create Draft Post)
  → Gemini Image Generator
  → WordPress (Set Featured Image)
  → WordPress (Publish Post)

Google Sheets (Get Product Info)
  → Gemini Image Generator (Product Image)
  → Twitter (Post with Image)

E-commerce Product Images

Shopify (New Product)
  → Gemini Image Generator (Generate lifestyle image)
  → Shopify (Upload Product Image)

🔍 Troubleshooting

"Field not found or empty in input data"

Cause: The input field name doesn't match the data from the previous node.

Solution:

Click the Gemini node
Click "Execute Previous Node" to see the output
Find the exact field name containing your content
Update "Input Field Name" parameter

"No image data found in response"

Causes:

Invalid API key
Model doesn't support image generation
Prompt not suitable for image generation

Solutions:

Verify API key at Google AI Studio
Try different model
Simplify your prompt

Image not uploading to WordPress