n8n-nodes-pollinations-ai 1.1.0 → 1.2.1

package/README.md

@@ -16,7 +16,16 @@ Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes
 2. Select **Install**
 3. Enter `n8n-nodes-pollinations-ai` and confirm
 
-## Operations
+## Nodes
+
+This package includes two nodes:
+
+| Node | Description |
+|------|-------------|
+| **Pollinations** | Main node for image and text generation |
+| **Pollinations Chat Model** | Sub-node for AI Agent integration |
+
+## Operations (Pollinations Node)
 
 ### Generate Image
 
@@ -40,6 +49,37 @@ Generate an image from a text prompt using Pollinations AI.
 | Enhance Prompt | false | Automatically enhance the prompt |
 | Safe Mode | false | Enable content safety filter |
 
+### Generate with Reference
+
+Generate an image using a reference image (image-to-image). Only models supporting image input are shown.
+
+**Parameters:**
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| Prompt | Yes | Text describing how to transform or use the reference image |
+| Reference Image URL | Yes | URL of the reference image (must be publicly accessible) |
+| Model | Yes | The model to use (only models with image input support) |
+
+**Advanced Options:**
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| Width | 1024 | Width of the generated image (64-2048) |
+| Height | 1024 | Height of the generated image (64-2048) |
+| Seed | 0 | Seed for reproducible generation (0 = random) |
+| No Logo | false | Remove the Pollinations watermark |
+| Enhance Prompt | false | Automatically enhance the prompt |
+| Safe Mode | false | Enable content safety filter |
+
+**Supported Models:**
+
+Models are filtered dynamically from the API. Common models supporting reference images include:
+- FLUX.1 Kontext
+- NanoBanana / NanoBanana Pro
+- Seedream 4.0
+- GPT Image
+
 ### Generate Text
 
 Generate text from a prompt using AI language models.
@@ -60,6 +100,41 @@ Generate text from a prompt using AI language models.
 | JSON Response | false | Force the response in JSON format (not supported by all models) |
 | Seed | -1 | Seed for reproducible results (-1 = random) |
 
+## Pollinations Chat Model (Sub-node)
+
+A sub-node designed for use with **AI Agents** and **LLM Chains** in n8n. This node provides a language model that can be connected to AI workflow nodes.
+
+### Use Cases
+
+- Connect to **AI Agent** nodes for conversational AI workflows
+- Use with **LLM Chain** nodes for text processing pipelines
+- Build custom AI assistants using n8n's AI capabilities
+
+### Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| Model | Yes | The chat model to use (loaded dynamically from API) |
+| Temperature | Yes | Controls randomness: 0 = deterministic, 2 = very creative (default: 1) |
+
+### Advanced Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| Max Tokens | 0 | Maximum tokens in response (0 = model default) |
+| Top P | 1 | Nucleus sampling parameter (0-1) |
+| Frequency Penalty | 0 | Reduce repetition of token sequences (-2 to 2) |
+| Presence Penalty | 0 | Increase likelihood of new topics (-2 to 2) |
+| Timeout | 60000 | Request timeout in milliseconds |
+
+### How to Use
+
+1. Add an **AI Agent** or **LLM Chain** node to your workflow
+2. Add a **Pollinations Chat Model** node
+3. Connect the Chat Model output to the Agent/Chain model input
+4. Configure your Pollinations API credentials
+5. Select a model and adjust parameters as needed
+
 ## Credentials
 
 To use this node, you need a Pollinations API key.
@@ -132,6 +207,22 @@ The output will be a binary image that you can:
 - Send via email or messaging platforms
 - Process with other image manipulation nodes
 
+### Image-to-Image with Reference
+
+1. Add a **Pollinations** node to your workflow
+2. Select **Generate with Reference** operation
+3. Select your Pollinations API credentials
+4. Enter a prompt like "Transform into a watercolor painting"
+5. Enter the URL of your reference image
+6. Select a model (e.g., Kontext)
+7. Execute the node
+
+Use cases for reference images:
+- **Style transfer**: Apply artistic styles to existing images
+- **Consistent characters**: Generate variations of a character for tutorials
+- **Image editing**: Modify specific aspects of an image with text prompts
+- **Product variations**: Create different versions of product images
+
 ### Basic Text Generation
 
 1. Add a **Pollinations** node to your workflow
@@ -144,6 +235,18 @@ The output will be a binary image that you can:
 
 The output will be a JSON object with the generated text and metadata.
 
+### AI Agent Integration
+
+1. Add an **AI Agent** node to your workflow
+2. Add a **Pollinations Chat Model** node
+3. Connect the Chat Model to the Agent's model input
+4. Configure your Pollinations API credentials on the Chat Model
+5. Select a model (e.g., OpenAI, Claude, or DeepSeek)
+6. Add tools to your Agent as needed
+7. Execute the workflow
+
+This setup allows you to build conversational AI assistants powered by Pollinations models.
+
 ## Compatibility
 
 - n8n version: 1.0.0 or later

package/dist/nodes/Pollinations/Pollinations.node.d.ts

@@ -5,6 +5,7 @@ export declare class Pollinations implements INodeType {
         loadOptions: {
             getImageModels(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
             getTextModels(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+            getImageModelsWithReferenceSupport(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
         };
     };
     execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;

package/dist/nodes/Pollinations/Pollinations.node.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Pollinations = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
 class Pollinations {
     constructor() {
         this.description = {
@@ -36,6 +37,12 @@ class Pollinations {
                             description: 'Generate an image from a text prompt',
                             action: 'Generate an image from a text prompt',
                         },
+                        {
+                            name: 'Generate with Reference',
+                            value: 'generateImageWithReference',
+                            description: 'Generate an image using a reference image',
+                            action: 'Generate an image using a reference image',
+                        },
                         {
                             name: 'Generate Text',
                             value: 'generateText',
@@ -144,6 +151,120 @@ class Pollinations {
                         },
                     ],
                 },
+                // ==================== GENERATE IMAGE WITH REFERENCE ====================
+                // Prompt (Reference)
+                {
+                    displayName: 'Prompt',
+                    name: 'referencePrompt',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            operation: ['generateImageWithReference'],
+                        },
+                    },
+                    description: 'The text prompt describing how to transform or use the reference image',
+                    typeOptions: {
+                        rows: 4,
+                    },
+                },
+                // Reference Image URL (Required)
+                {
+                    displayName: 'Reference Image URL',
+                    name: 'referenceImage',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            operation: ['generateImageWithReference'],
+                        },
+                    },
+                    placeholder: 'https://example.com/image.jpg',
+                    description: 'URL of the reference image. Must be publicly accessible.',
+                },
+                // Model (Reference) - Dynamic loading with image input support
+                {
+                    displayName: 'Model',
+                    name: 'referenceModel',
+                    type: 'options',
+                    default: 'kontext',
+                    displayOptions: {
+                        show: {
+                            operation: ['generateImageWithReference'],
+                        },
+                    },
+                    typeOptions: {
+                        loadOptionsMethod: 'getImageModelsWithReferenceSupport',
+                    },
+                    description: 'The model to use. Only models supporting image input are shown.',
+                },
+                // Advanced Options (Reference)
+                {
+                    displayName: 'Options',
+                    name: 'referenceOptions',
+                    type: 'collection',
+                    placeholder: 'Add Option',
+                    default: {},
+                    displayOptions: {
+                        show: {
+                            operation: ['generateImageWithReference'],
+                        },
+                    },
+                    options: [
+                        {
+                            displayName: 'Width',
+                            name: 'width',
+                            type: 'number',
+                            default: 1024,
+                            description: 'Width of the generated image in pixels',
+                            typeOptions: {
+                                minValue: 64,
+                                maxValue: 2048,
+                            },
+                        },
+                        {
+                            displayName: 'Height',
+                            name: 'height',
+                            type: 'number',
+                            default: 1024,
+                            description: 'Height of the generated image in pixels',
+                            typeOptions: {
+                                minValue: 64,
+                                maxValue: 2048,
+                            },
+                        },
+                        {
+                            displayName: 'Seed',
+                            name: 'seed',
+                            type: 'number',
+                            default: 0,
+                            description: 'Seed for reproducible generation. Use 0 for random.',
+                        },
+                        {
+                            displayName: 'No Logo',
+                            name: 'nologo',
+                            type: 'boolean',
+                            default: false,
+                            description: 'Whether to remove the Pollinations watermark',
+                        },
+                        {
+                            displayName: 'Enhance Prompt',
+                            name: 'enhance',
+                            type: 'boolean',
+                            default: false,
+                            description: 'Whether to automatically enhance the prompt for better results',
+                        },
+                        {
+                            displayName: 'Safe Mode',
+                            name: 'safe',
+                            type: 'boolean',
+                            default: false,
+                            description: 'Whether to enable content safety filter',
+                        },
+                    ],
+                },
                 // ==================== GENERATE TEXT ====================
                 // Prompt (Text)
                 {
@@ -353,6 +474,55 @@ class Pollinations {
                         ];
                     }
                 },
+                async getImageModelsWithReferenceSupport() {
+                    try {
+                        const credentials = await this.getCredentials('pollinationsApi');
+                        const apiKey = credentials.apiKey;
+                        const response = await this.helpers.httpRequest({
+                            method: 'GET',
+                            url: 'https://gen.pollinations.ai/image/models',
+                            headers: {
+                                Authorization: `Bearer ${apiKey}`,
+                            },
+                        });
+                        if (Array.isArray(response)) {
+                            // Filter only image models that support image input (for reference/transformation)
+                            const imageModels = response.filter((model) => model.output_modalities?.includes('image') &&
+                                !model.output_modalities?.includes('video') &&
+                                model.input_modalities?.includes('image'));
+                            return imageModels.map((model) => {
+                                let displayName = model.description || model.name;
+                                // Add pricing info if available
+                                if (model.pricing?.completionImageTokens) {
+                                    const imagesPerPollen = Math.floor(1 / model.pricing.completionImageTokens);
+                                    displayName += ` (~${imagesPerPollen.toLocaleString()} img/$)`;
+                                }
+                                return {
+                                    name: displayName,
+                                    value: model.name,
+                                };
+                            });
+                        }
+                        // Fallback if API fails
+                        return [
+                            { name: 'FLUX.1 Kontext', value: 'kontext' },
+                            { name: 'NanoBanana', value: 'nanobanana' },
+                            { name: 'NanoBanana Pro', value: 'nanobanana-pro' },
+                            { name: 'Seedream 4.0', value: 'seedream' },
+                            { name: 'GPT Image 1 Mini', value: 'gptimage' },
+                        ];
+                    }
+                    catch {
+                        // Fallback if API fails
+                        return [
+                            { name: 'FLUX.1 Kontext', value: 'kontext' },
+                            { name: 'NanoBanana', value: 'nanobanana' },
+                            { name: 'NanoBanana Pro', value: 'nanobanana-pro' },
+                            { name: 'Seedream 4.0', value: 'seedream' },
+                            { name: 'GPT Image 1 Mini', value: 'gptimage' },
+                        ];
+                    }
+                },
             },
         };
     }
@@ -516,6 +686,94 @@ class Pollinations {
                     json: metadata,
                 });
             }
+            if (operation === 'generateImageWithReference') {
+                const prompt = this.getNodeParameter('referencePrompt', i);
+                const referenceImage = this.getNodeParameter('referenceImage', i);
+                const model = this.getNodeParameter('referenceModel', i);
+                const options = this.getNodeParameter('referenceOptions', i, {});
+                // Validate reference image URL
+                try {
+                    new URL(referenceImage);
+                }
+                catch {
+                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Invalid reference image URL: "${referenceImage}"`, { itemIndex: i });
+                }
+                // Get credentials
+                const credentials = await this.getCredentials('pollinationsApi');
+                const apiKey = credentials.apiKey;
+                // Build query parameters
+                const queryParams = {
+                    model,
+                    image: referenceImage,
+                };
+                if (options.width) {
+                    queryParams.width = options.width.toString();
+                }
+                if (options.height) {
+                    queryParams.height = options.height.toString();
+                }
+                if (options.seed) {
+                    queryParams.seed = options.seed.toString();
+                }
+                if (options.nologo) {
+                    queryParams.nologo = 'true';
+                }
+                if (options.enhance) {
+                    queryParams.enhance = 'true';
+                }
+                if (options.safe) {
+                    queryParams.safe = 'true';
+                }
+                // Build the URL
+                const baseUrl = 'https://gen.pollinations.ai/image';
+                const encodedPrompt = encodeURIComponent(prompt);
+                const queryString = new URLSearchParams(queryParams).toString();
+                const fullUrl = `${baseUrl}/${encodedPrompt}?${queryString}`;
+                // Record start time
+                const startTime = Date.now();
+                // Make the request with authentication
+                const response = await this.helpers.httpRequest({
+                    method: 'GET',
+                    url: fullUrl,
+                    headers: {
+                        Authorization: `Bearer ${apiKey}`,
+                    },
+                    encoding: 'arraybuffer',
+                    returnFullResponse: true,
+                });
+                // Calculate duration
+                const duration = Date.now() - startTime;
+                // Prepare binary data
+                const binaryData = await this.helpers.prepareBinaryData(Buffer.from(response.body), 'image.png', 'image/png');
+                // Build metadata for debugging
+                const metadata = {
+                    request: {
+                        url: fullUrl,
+                        prompt,
+                        model,
+                        referenceImage,
+                        width: options.width || 1024,
+                        height: options.height || 1024,
+                        seed: options.seed || null,
+                        nologo: options.nologo || false,
+                        enhance: options.enhance || false,
+                        safe: options.safe || false,
+                    },
+                    response: {
+                        statusCode: response.statusCode,
+                        contentType: response.headers?.['content-type'] || 'image/png',
+                        contentLength: response.headers?.['content-length'] || null,
+                        duration: `${duration}ms`,
+                    },
+                    timestamp: new Date().toISOString(),
+                };
+                returnData.push({
+                    json: metadata,
+                    binary: {
+                        data: binaryData,
+                    },
+                });
+            }
         }
         return [returnData];
     }

package/nodes/Pollinations/Pollinations.node.ts

@@ -5,6 +5,7 @@ import {
 	INodePropertyOptions,
 	INodeType,
 	INodeTypeDescription,
+	NodeOperationError,
 } from 'n8n-workflow';
 
 export class Pollinations implements INodeType {
@@ -41,6 +42,12 @@ export class Pollinations implements INodeType {
 						description: 'Generate an image from a text prompt',
 						action: 'Generate an image from a text prompt',
 					},
+					{
+						name: 'Generate with Reference',
+						value: 'generateImageWithReference',
+						description: 'Generate an image using a reference image',
+						action: 'Generate an image using a reference image',
+					},
 					{
 						name: 'Generate Text',
 						value: 'generateText',
@@ -154,6 +161,125 @@ export class Pollinations implements INodeType {
 				],
 			},
 
+			// ==================== GENERATE IMAGE WITH REFERENCE ====================
+
+			// Prompt (Reference)
+			{
+				displayName: 'Prompt',
+				name: 'referencePrompt',
+				type: 'string',
+				default: '',
+				required: true,
+				displayOptions: {
+					show: {
+						operation: ['generateImageWithReference'],
+					},
+				},
+				description: 'The text prompt describing how to transform or use the reference image',
+				typeOptions: {
+					rows: 4,
+				},
+			},
+
+			// Reference Image URL (Required)
+			{
+				displayName: 'Reference Image URL',
+				name: 'referenceImage',
+				type: 'string',
+				default: '',
+				required: true,
+				displayOptions: {
+					show: {
+						operation: ['generateImageWithReference'],
+					},
+				},
+				placeholder: 'https://example.com/image.jpg',
+				description: 'URL of the reference image. Must be publicly accessible.',
+			},
+
+			// Model (Reference) - Dynamic loading with image input support
+			{
+				displayName: 'Model',
+				name: 'referenceModel',
+				type: 'options',
+				default: 'kontext',
+				displayOptions: {
+					show: {
+						operation: ['generateImageWithReference'],
+					},
+				},
+				typeOptions: {
+					loadOptionsMethod: 'getImageModelsWithReferenceSupport',
+				},
+				description: 'The model to use. Only models supporting image input are shown.',
+			},
+
+			// Advanced Options (Reference)
+			{
+				displayName: 'Options',
+				name: 'referenceOptions',
+				type: 'collection',
+				placeholder: 'Add Option',
+				default: {},
+				displayOptions: {
+					show: {
+						operation: ['generateImageWithReference'],
+					},
+				},
+				options: [
+					{
+						displayName: 'Width',
+						name: 'width',
+						type: 'number',
+						default: 1024,
+						description: 'Width of the generated image in pixels',
+						typeOptions: {
+							minValue: 64,
+							maxValue: 2048,
+						},
+					},
+					{
+						displayName: 'Height',
+						name: 'height',
+						type: 'number',
+						default: 1024,
+						description: 'Height of the generated image in pixels',
+						typeOptions: {
+							minValue: 64,
+							maxValue: 2048,
+						},
+					},
+					{
+						displayName: 'Seed',
+						name: 'seed',
+						type: 'number',
+						default: 0,
+						description: 'Seed for reproducible generation. Use 0 for random.',
+					},
+					{
+						displayName: 'No Logo',
+						name: 'nologo',
+						type: 'boolean',
+						default: false,
+						description: 'Whether to remove the Pollinations watermark',
+					},
+					{
+						displayName: 'Enhance Prompt',
+						name: 'enhance',
+						type: 'boolean',
+						default: false,
+						description: 'Whether to automatically enhance the prompt for better results',
+					},
+					{
+						displayName: 'Safe Mode',
+						name: 'safe',
+						type: 'boolean',
+						default: false,
+						description: 'Whether to enable content safety filter',
+					},
+				],
+			},
+
 			// ==================== GENERATE TEXT ====================
 
 			// Prompt (Text)
@@ -399,6 +525,72 @@ export class Pollinations implements INodeType {
 					];
 				}
 			},
+
+			async getImageModelsWithReferenceSupport(
+				this: ILoadOptionsFunctions,
+			): Promise<INodePropertyOptions[]> {
+				try {
+					const credentials = await this.getCredentials('pollinationsApi');
+					const apiKey = credentials.apiKey as string;
+
+					const response = await this.helpers.httpRequest({
+						method: 'GET',
+						url: 'https://gen.pollinations.ai/image/models',
+						headers: {
+							Authorization: `Bearer ${apiKey}`,
+						},
+					});
+
+					if (Array.isArray(response)) {
+						// Filter only image models that support image input (for reference/transformation)
+						const imageModels = response.filter(
+							(model: { output_modalities?: string[]; input_modalities?: string[] }) =>
+								model.output_modalities?.includes('image') &&
+								!model.output_modalities?.includes('video') &&
+								model.input_modalities?.includes('image'),
+						);
+
+						return imageModels.map(
+							(model: {
+								name: string;
+								description: string;
+								pricing?: { completionImageTokens?: number };
+							}) => {
+								let displayName = model.description || model.name;
+
+								// Add pricing info if available
+								if (model.pricing?.completionImageTokens) {
+									const imagesPerPollen = Math.floor(1 / model.pricing.completionImageTokens);
+									displayName += ` (~${imagesPerPollen.toLocaleString()} img/$)`;
+								}
+
+								return {
+									name: displayName,
+									value: model.name,
+								};
+							},
+						);
+					}
+
+					// Fallback if API fails
+					return [
+						{ name: 'FLUX.1 Kontext', value: 'kontext' },
+						{ name: 'NanoBanana', value: 'nanobanana' },
+						{ name: 'NanoBanana Pro', value: 'nanobanana-pro' },
+						{ name: 'Seedream 4.0', value: 'seedream' },
+						{ name: 'GPT Image 1 Mini', value: 'gptimage' },
+					];
+				} catch {
+					// Fallback if API fails
+					return [
+						{ name: 'FLUX.1 Kontext', value: 'kontext' },
+						{ name: 'NanoBanana', value: 'nanobanana' },
+						{ name: 'NanoBanana Pro', value: 'nanobanana-pro' },
+						{ name: 'Seedream 4.0', value: 'seedream' },
+						{ name: 'GPT Image 1 Mini', value: 'gptimage' },
+					];
+				}
+			},
 		},
 	};
 
@@ -599,6 +791,120 @@ export class Pollinations implements INodeType {
 					json: metadata,
 				});
 			}
+
+			if (operation === 'generateImageWithReference') {
+				const prompt = this.getNodeParameter('referencePrompt', i) as string;
+				const referenceImage = this.getNodeParameter('referenceImage', i) as string;
+				const model = this.getNodeParameter('referenceModel', i) as string;
+				const options = this.getNodeParameter('referenceOptions', i, {}) as {
+					width?: number;
+					height?: number;
+					seed?: number;
+					nologo?: boolean;
+					enhance?: boolean;
+					safe?: boolean;
+				};
+
+				// Validate reference image URL
+				try {
+					new URL(referenceImage);
+				} catch {
+					throw new NodeOperationError(
+						this.getNode(),
+						`Invalid reference image URL: "${referenceImage}"`,
+						{ itemIndex: i },
+					);
+				}
+
+				// Get credentials
+				const credentials = await this.getCredentials('pollinationsApi');
+				const apiKey = credentials.apiKey as string;
+
+				// Build query parameters
+				const queryParams: Record<string, string> = {
+					model,
+					image: referenceImage,
+				};
+
+				if (options.width) {
+					queryParams.width = options.width.toString();
+				}
+				if (options.height) {
+					queryParams.height = options.height.toString();
+				}
+				if (options.seed) {
+					queryParams.seed = options.seed.toString();
+				}
+				if (options.nologo) {
+					queryParams.nologo = 'true';
+				}
+				if (options.enhance) {
+					queryParams.enhance = 'true';
+				}
+				if (options.safe) {
+					queryParams.safe = 'true';
+				}
+
+				// Build the URL
+				const baseUrl = 'https://gen.pollinations.ai/image';
+				const encodedPrompt = encodeURIComponent(prompt);
+				const queryString = new URLSearchParams(queryParams).toString();
+				const fullUrl = `${baseUrl}/${encodedPrompt}?${queryString}`;
+
+				// Record start time
+				const startTime = Date.now();
+
+				// Make the request with authentication
+				const response = await this.helpers.httpRequest({
+					method: 'GET',
+					url: fullUrl,
+					headers: {
+						Authorization: `Bearer ${apiKey}`,
+					},
+					encoding: 'arraybuffer',
+					returnFullResponse: true,
+				});
+
+				// Calculate duration
+				const duration = Date.now() - startTime;
+
+				// Prepare binary data
+				const binaryData = await this.helpers.prepareBinaryData(
+					Buffer.from(response.body as ArrayBuffer),
+					'image.png',
+					'image/png',
+				);
+
+				// Build metadata for debugging
+				const metadata = {
+					request: {
+						url: fullUrl,
+						prompt,
+						model,
+						referenceImage,
+						width: options.width || 1024,
+						height: options.height || 1024,
+						seed: options.seed || null,
+						nologo: options.nologo || false,
+						enhance: options.enhance || false,
+						safe: options.safe || false,
+					},
+					response: {
+						statusCode: response.statusCode,
+						contentType: response.headers?.['content-type'] || 'image/png',
+						contentLength: response.headers?.['content-length'] || null,
+						duration: `${duration}ms`,
+					},
+					timestamp: new Date().toISOString(),
+				};
+
+				returnData.push({
+					json: metadata,
+					binary: {
+						data: binaryData,
+					},
+				});
+			}
 		}
 
 		return [returnData];

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "n8n-nodes-pollinations-ai",
-	"version": "1.1.0",
+	"version": "1.2.1",
 	"description": "n8n community node for Pollinations AI - image generation and chat models",
 	"keywords": [
 		"n8n-community-node-package",