n8n-nodes-pollinations-ai 1.2.0 → 1.3.0

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/credentials/PollinationsApi.credentials.d.ts

@@ -2,6 +2,7 @@ import { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodePro
 export declare class PollinationsApi implements ICredentialType {
     name: string;
     displayName: string;
+    icon: "file:pollinations.svg";
     documentationUrl: string;
     properties: INodeProperties[];
     authenticate: IAuthenticateGeneric;

package/dist/credentials/PollinationsApi.credentials.js

@@ -5,6 +5,7 @@ class PollinationsApi {
     constructor() {
         this.name = 'pollinationsApi';
         this.displayName = 'Pollinations API';
+        this.icon = 'file:pollinations.svg';
         this.documentationUrl = 'https://github.com/new-xmon-df/n8n-nodes-pollinations-ai#credentials';
         this.properties = [
             {

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

@@ -2,6 +2,55 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Pollinations = void 0;
 const n8n_workflow_1 = require("n8n-workflow");
+/**
+ * Handle HTTP errors from Pollinations API with user-friendly messages
+ */
+function handlePollinationsError(error, node, itemIndex, context) {
+    const httpError = error;
+    const status = httpError.response?.status;
+    switch (status) {
+        case 400:
+            throw new n8n_workflow_1.NodeOperationError(node, `Invalid request: ${httpError.message || 'Check your input parameters'}`, { itemIndex });
+        case 401:
+            throw new n8n_workflow_1.NodeOperationError(node, 'Authentication failed. Please check your API key is valid.', { itemIndex });
+        case 403:
+            if (context === 'balance') {
+                throw new n8n_workflow_1.NodeOperationError(node, 'API key does not have "Balance" permission. Please generate a new API key at https://enter.pollinations.ai with the "Balance" permission enabled.', { itemIndex });
+            }
+            throw new n8n_workflow_1.NodeOperationError(node, 'Permission denied. Your API key may not have the required permissions for this operation.', { itemIndex });
+        case 429:
+            throw new n8n_workflow_1.NodeOperationError(node, 'Rate limit exceeded. Please wait a moment before trying again.', { itemIndex });
+        case 500:
+        case 502:
+        case 503:
+            throw new n8n_workflow_1.NodeOperationError(node, 'Pollinations API is temporarily unavailable. Please try again later.', { itemIndex });
+        default:
+            throw error;
+    }
+}
+async function checkMinimumBalance(context, minimumBalance, itemIndex) {
+    if (minimumBalance <= 0)
+        return;
+    const credentials = await context.getCredentials('pollinationsApi');
+    const apiKey = credentials.apiKey;
+    let response;
+    try {
+        response = await context.helpers.httpRequest({
+            method: 'GET',
+            url: 'https://gen.pollinations.ai/account/balance',
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+            },
+        });
+    }
+    catch (error) {
+        handlePollinationsError(error, context.getNode(), itemIndex, 'balance');
+    }
+    const currentBalance = response.balance;
+    if (currentBalance < minimumBalance) {
+        throw new n8n_workflow_1.NodeOperationError(context.getNode(), `Insufficient balance: ${currentBalance} pollens available, ${minimumBalance} required`, { itemIndex });
+    }
+}
 class Pollinations {
     constructor() {
         this.description = {
@@ -49,6 +98,12 @@ class Pollinations {
                             description: 'Generate text from a prompt using AI',
                             action: 'Generate text from a prompt',
                         },
+                        {
+                            name: 'Get Balance',
+                            value: 'getBalance',
+                            description: 'Get current pollen balance from your account',
+                            action: 'Get current pollen balance',
+                        },
                     ],
                     default: 'generateImage',
                 },
@@ -72,10 +127,10 @@ class Pollinations {
                 },
                 // Model (Image) - Dynamic loading
                 {
-                    displayName: 'Model',
+                    displayName: 'Model Name or ID',
                     name: 'model',
                     type: 'options',
-                    default: 'flux',
+                    default: '',
                     displayOptions: {
                         show: {
                             operation: ['generateImage'],
@@ -84,7 +139,7 @@ class Pollinations {
                     typeOptions: {
                         loadOptionsMethod: 'getImageModels',
                     },
-                    description: 'The model to use for image generation',
+                    description: 'The model to use for image generation. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
                 },
                 // Advanced Options (Image)
                 {
@@ -100,15 +155,11 @@ class Pollinations {
                     },
                     options: [
                         {
-                            displayName: 'Width',
-                            name: 'width',
-                            type: 'number',
-                            default: 1024,
-                            description: 'Width of the generated image in pixels',
-                            typeOptions: {
-                                minValue: 64,
-                                maxValue: 2048,
-                            },
+                            displayName: 'Enhance Prompt',
+                            name: 'enhance',
+                            type: 'boolean',
+                            default: false,
+                            description: 'Whether to automatically enhance the prompt for better results',
                         },
                         {
                             displayName: 'Height',
@@ -122,11 +173,14 @@ class Pollinations {
                             },
                         },
                         {
-                            displayName: 'Seed',
-                            name: 'seed',
+                            displayName: 'Minimum Balance',
+                            name: 'minimumBalance',
                             type: 'number',
                             default: 0,
-                            description: 'Seed for reproducible generation. Use 0 for random.',
+                            description: 'Minimum pollen balance required to execute. Set to 0 to disable check.',
+                            typeOptions: {
+                                minValue: 0,
+                            },
                         },
                         {
                             displayName: 'No Logo',
@@ -135,13 +189,6 @@ class Pollinations {
                             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',
@@ -149,6 +196,24 @@ class Pollinations {
                             default: false,
                             description: 'Whether to enable content safety filter',
                         },
+                        {
+                            displayName: 'Seed',
+                            name: 'seed',
+                            type: 'number',
+                            default: 0,
+                            description: 'Seed for reproducible generation. Use 0 for random.',
+                        },
+                        {
+                            displayName: 'Width',
+                            name: 'width',
+                            type: 'number',
+                            default: 1024,
+                            description: 'Width of the generated image in pixels',
+                            typeOptions: {
+                                minValue: 64,
+                                maxValue: 2048,
+                            },
+                        },
                     ],
                 },
                 // ==================== GENERATE IMAGE WITH REFERENCE ====================
@@ -186,10 +251,10 @@ class Pollinations {
                 },
                 // Model (Reference) - Dynamic loading with image input support
                 {
-                    displayName: 'Model',
+                    displayName: 'Model Name or ID',
                     name: 'referenceModel',
                     type: 'options',
-                    default: 'kontext',
+                    default: '',
                     displayOptions: {
                         show: {
                             operation: ['generateImageWithReference'],
@@ -198,7 +263,7 @@ class Pollinations {
                     typeOptions: {
                         loadOptionsMethod: 'getImageModelsWithReferenceSupport',
                     },
-                    description: 'The model to use. Only models supporting image input are shown.',
+                    description: 'The model to use. Only models supporting image input are shown. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
                 },
                 // Advanced Options (Reference)
                 {
@@ -214,15 +279,11 @@ class Pollinations {
                     },
                     options: [
                         {
-                            displayName: 'Width',
-                            name: 'width',
-                            type: 'number',
-                            default: 1024,
-                            description: 'Width of the generated image in pixels',
-                            typeOptions: {
-                                minValue: 64,
-                                maxValue: 2048,
-                            },
+                            displayName: 'Enhance Prompt',
+                            name: 'enhance',
+                            type: 'boolean',
+                            default: false,
+                            description: 'Whether to automatically enhance the prompt for better results',
                         },
                         {
                             displayName: 'Height',
@@ -236,11 +297,14 @@ class Pollinations {
                             },
                         },
                         {
-                            displayName: 'Seed',
-                            name: 'seed',
+                            displayName: 'Minimum Balance',
+                            name: 'minimumBalance',
                             type: 'number',
                             default: 0,
-                            description: 'Seed for reproducible generation. Use 0 for random.',
+                            description: 'Minimum pollen balance required to execute. Set to 0 to disable check.',
+                            typeOptions: {
+                                minValue: 0,
+                            },
                         },
                         {
                             displayName: 'No Logo',
@@ -249,13 +313,6 @@ class Pollinations {
                             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',
@@ -263,6 +320,24 @@ class Pollinations {
                             default: false,
                             description: 'Whether to enable content safety filter',
                         },
+                        {
+                            displayName: 'Seed',
+                            name: 'seed',
+                            type: 'number',
+                            default: 0,
+                            description: 'Seed for reproducible generation. Use 0 for random.',
+                        },
+                        {
+                            displayName: 'Width',
+                            name: 'width',
+                            type: 'number',
+                            default: 1024,
+                            description: 'Width of the generated image in pixels',
+                            typeOptions: {
+                                minValue: 64,
+                                maxValue: 2048,
+                            },
+                        },
                     ],
                 },
                 // ==================== GENERATE TEXT ====================
@@ -285,10 +360,10 @@ class Pollinations {
                 },
                 // Model (Text) - Dynamic loading
                 {
-                    displayName: 'Model',
+                    displayName: 'Model Name or ID',
                     name: 'textModel',
                     type: 'options',
-                    default: 'openai',
+                    default: '',
                     displayOptions: {
                         show: {
                             operation: ['generateText'],
@@ -297,7 +372,7 @@ class Pollinations {
                     typeOptions: {
                         loadOptionsMethod: 'getTextModels',
                     },
-                    description: 'The AI model to use for text generation',
+                    description: 'The AI model to use for text generation. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
                 },
                 // System Prompt (Text)
                 {
@@ -354,6 +429,16 @@ class Pollinations {
                             default: false,
                             description: 'Whether to force the response in JSON format. Not supported by all models.',
                         },
+                        {
+                            displayName: 'Minimum Balance',
+                            name: 'minimumBalance',
+                            type: 'number',
+                            default: 0,
+                            description: 'Minimum pollen balance required to execute. Set to 0 to disable check.',
+                            typeOptions: {
+                                minValue: 0,
+                            },
+                        },
                         {
                             displayName: 'Seed',
                             name: 'seed',
@@ -364,6 +449,7 @@ class Pollinations {
                     ],
                 },
             ],
+            usableAsTool: true,
         };
         this.methods = {
             loadOptions: {
@@ -529,12 +615,37 @@ class Pollinations {
     async execute() {
         const items = this.getInputData();
         const returnData = [];
+        const operation = this.getNodeParameter('operation', 0);
+        // Handle account operations outside the loop (they don't depend on input items)
+        if (operation === 'getBalance') {
+            const credentials = await this.getCredentials('pollinationsApi');
+            const apiKey = credentials.apiKey;
+            let response;
+            try {
+                response = await this.helpers.httpRequest({
+                    method: 'GET',
+                    url: 'https://gen.pollinations.ai/account/balance',
+                    headers: {
+                        Authorization: `Bearer ${apiKey}`,
+                    },
+                });
+            }
+            catch (error) {
+                handlePollinationsError(error, this.getNode(), 0, 'balance');
+            }
+            returnData.push({
+                json: response,
+            });
+            return [returnData];
+        }
         for (let i = 0; i < items.length; i++) {
-            const operation = this.getNodeParameter('operation', i);
             if (operation === 'generateImage') {
                 const prompt = this.getNodeParameter('prompt', i);
                 const model = this.getNodeParameter('model', i);
                 const options = this.getNodeParameter('options', i, {});
+                // Check minimum balance if configured
+                const minimumBalance = options.minimumBalance || 0;
+                await checkMinimumBalance(this, minimumBalance, i);
                 // Get credentials
                 const credentials = await this.getCredentials('pollinationsApi');
                 const apiKey = credentials.apiKey;
@@ -568,15 +679,21 @@ class Pollinations {
                 // 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,
-                });
+                let response;
+                try {
+                    response = await this.helpers.httpRequest({
+                        method: 'GET',
+                        url: fullUrl,
+                        headers: {
+                            Authorization: `Bearer ${apiKey}`,
+                        },
+                        encoding: 'arraybuffer',
+                        returnFullResponse: true,
+                    });
+                }
+                catch (error) {
+                    handlePollinationsError(error, this.getNode(), i, 'image');
+                }
                 // Calculate duration
                 const duration = Date.now() - startTime;
                 // Prepare binary data
@@ -616,6 +733,9 @@ class Pollinations {
                 const temperature = this.getNodeParameter('temperature', i);
                 const textOptions = this.getNodeParameter('textOptions', i, {});
                 const jsonMode = textOptions.jsonMode || false;
+                // Check minimum balance if configured
+                const minimumBalance = textOptions.minimumBalance || 0;
+                await checkMinimumBalance(this, minimumBalance, i);
                 // Get credentials
                 const credentials = await this.getCredentials('pollinationsApi');
                 const apiKey = credentials.apiKey;
@@ -641,14 +761,20 @@ class Pollinations {
                 // 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}`,
-                    },
-                    returnFullResponse: true,
-                });
+                let response;
+                try {
+                    response = await this.helpers.httpRequest({
+                        method: 'GET',
+                        url: fullUrl,
+                        headers: {
+                            Authorization: `Bearer ${apiKey}`,
+                        },
+                        returnFullResponse: true,
+                    });
+                }
+                catch (error) {
+                    handlePollinationsError(error, this.getNode(), i, 'text');
+                }
                 // Calculate duration
                 const duration = Date.now() - startTime;
                 // Parse response text
@@ -691,6 +817,9 @@ class Pollinations {
                 const referenceImage = this.getNodeParameter('referenceImage', i);
                 const model = this.getNodeParameter('referenceModel', i);
                 const options = this.getNodeParameter('referenceOptions', i, {});
+                // Check minimum balance if configured
+                const minimumBalance = options.minimumBalance || 0;
+                await checkMinimumBalance(this, minimumBalance, i);
                 // Validate reference image URL
                 try {
                     new URL(referenceImage);
@@ -732,15 +861,21 @@ class Pollinations {
                 // 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,
-                });
+                let response;
+                try {
+                    response = await this.helpers.httpRequest({
+                        method: 'GET',
+                        url: fullUrl,
+                        headers: {
+                            Authorization: `Bearer ${apiKey}`,
+                        },
+                        encoding: 'arraybuffer',
+                        returnFullResponse: true,
+                    });
+                }
+                catch (error) {
+                    handlePollinationsError(error, this.getNode(), i, 'image');
+                }
                 // Calculate duration
                 const duration = Date.now() - startTime;
                 // Prepare binary data