n8n-nodes-pollinations-ai

This is an n8n community node that lets you generate images, text, speech and music using Pollinations AI in your n8n workflows.

Pollinations is an AI platform that provides access to various image, text and audio generation models.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation.

Quick Install

1. Go to Settings > Community Nodes
2. Select Install
3. Enter n8n-nodes-pollinations-ai and confirm

Nodes

This package includes two nodes:

Node	Description
Pollinations	Main node for image, text, speech and music generation
Pollinations Chat Model	Sub-node for AI Agent integration

Operations (Pollinations Node)

Generate Image

Generate an image from a text prompt using Pollinations AI.

Parameters:

Parameter	Required	Description
Prompt	Yes	The text prompt to generate the image from
Model	Yes	The model to use (loaded dynamically from API)

Advanced Options:

Option	Default	Description
Width	1024	Width of the generated image (64-2048)
Height	1024	Height of the generated image (64-2048)
Minimum Balance	0	Minimum pollen balance required to execute (0 = disabled)
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

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)
Minimum Balance	0	Minimum pollen balance required to execute (0 = disabled)
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.

Parameters:

Parameter	Required	Description
Prompt	Yes	The text prompt or question for the AI model
Model	Yes	The AI model to use (loaded dynamically from API)
System Prompt	No	Instructions that define the AI behavior and context
Temperature	No	Controls creativity: 0.0 = strict, 2.0 = very creative (default: 0.7)

Advanced Options:

Option	Default	Description
JSON Response	false	Force the response in JSON format (not supported by all models)
Minimum Balance	0	Minimum pollen balance required to execute (0 = disabled)
Seed	-1	Seed for reproducible results (-1 = random)

Generate Speech

Convert text to speech using TTS (Text-to-Speech) models.

Parameters:

Parameter	Required	Description
Text	Yes	The text to convert to speech
Model	Yes	The TTS model to use (loaded dynamically from API)
Voice	Yes	The voice to use for synthesis (loaded dynamically from API)

Advanced Options:

Option	Default	Description
Response Format	MP3	Audio format: AAC, FLAC, MP3, Opus, PCM, WAV
Minimum Balance	0	Minimum pollen balance required to execute (0 = disabled)

The output is a binary audio file with metadata including request details and response info.

Generate Music

Generate music from a text description.

Parameters:

Parameter	Required	Description
Prompt	Yes	Description of the music to generate
Model	Yes	The music model to use (loaded dynamically from API)
Duration (Seconds)	Yes	Duration of the generated music (3-300, default: 30)
Instrumental	No	Generate instrumental music only, no vocals (default: false)

Advanced Options:

Option	Default	Description
Minimum Balance	0	Minimum pollen balance required to execute (0 = disabled)

The output is a binary MP3 audio file with metadata including request details and response info.

Note: Music generation does not support specific artist names in prompts. Describe the style instead (e.g., "Latin pop with Middle Eastern melodic influences" instead of naming an artist).

Get Balance

Get the current pollen balance from your Pollinations account.

Output:

{
  "balance": 1250.50
}

This operation requires an API key with "Balance" permission enabled.

Balance Control

All generation operations (Generate Image, Generate with Reference, Generate Text, Generate Speech, Generate Music) include a Minimum Balance option in their advanced settings. This allows you to:

• Prevent unexpected costs: Stop workflow execution if balance is too low
• Budget management: Set thresholds for different workflows
• Error handling: Get a clear error message instead of failed API calls

When the current balance is below the minimum specified, the node throws an error:

Insufficient balance: 27.54 pollens available, 30 required

Set to 0 (default) to disable the balance check.

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.

Creating an API Key

1. Go to enter.pollinations.ai
2. Sign up or log in to your account
3. Navigate to API Keys section
4. Click Create API Key
5. Configure your key:
   • Name: Give your key a descriptive name (e.g., "n8n Integration")
   • Type: Choose between Publishable (pk_) or Secret (sk_)
   • Model Access: Select which models this key can use (see below)
6. Copy the generated key

Configuring Model Access

When creating an API key, you can restrict which models the key has access to. This is useful for:

• Cost control: Limit access to expensive models
• Security: Restrict capabilities of shared keys
• Organization: Create keys for specific use cases

The node automatically filters the model dropdown to show only the models your API key has permission to use. If you don't see a model you expect, check your key's model permissions at enter.pollinations.ai.

Setting up in n8n

1. In n8n, go to Credentials
2. Click Add Credential
3. Search for Pollinations API
4. Paste your API key
5. Click Save

API Key Types

Type	Prefix	Use Case	Rate Limits
Publishable	pk_	Client-side apps, testing	IP-based rate limiting
Secret	sk_	Server-side, production	No rate limits, can spend Pollen

Important: Secret keys (sk_) should never be exposed in client-side code. Use them only in server environments like n8n.

Available Models

Models are loaded dynamically from the Pollinations API, ensuring you always have access to the latest available models. Models that require a paid plan are marked with a [Paid] indicator in the dropdown.

Image Models

Common models include Flux, Turbo, GPT Image, Kontext, Seedream, and more.

Text Models

Common models include OpenAI GPT-5, Claude, Gemini, DeepSeek, Mistral, and more.

Audio Models

• TTS (Text-to-Speech): ElevenLabs with 30+ voices (alloy, nova, rachel, adam, etc.)
• Music: ElevenLabs Music for AI-generated music

Example Usage

Basic Image Generation

1. Add a Pollinations node to your workflow
2. Select Generate Image operation
3. Select your Pollinations API credentials
4. Enter a prompt like "A beautiful sunset over mountains"
5. Select a model (e.g., Flux)
6. Execute the node

The output will be a binary image that you can:

• Save to disk using the Write Binary File node
• Upload to cloud storage (S3, Google Drive, etc.)
• 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
2. Select Generate Text operation
3. Select your Pollinations API credentials
4. Enter a prompt like "Explain quantum computing in simple terms"
5. Optionally add a system prompt to define AI behavior
6. Select a model (e.g., OpenAI)
7. Execute the node

The output will be a JSON object with the generated text and metadata.

Text-to-Speech

1. Add a Pollinations node to your workflow
2. Select Generate Speech operation
3. Select your Pollinations API credentials
4. Enter the text to convert (e.g., "Welcome to our podcast")
5. Select a model and voice (e.g., ElevenLabs + Nova)
6. Optionally change the audio format in advanced options
7. Execute the node

The output will be a binary audio file that you can:

• Save to disk using the Write Binary File node
• Upload to cloud storage
• Send via messaging platforms
• Use in video/audio pipelines

Music Generation

1. Add a Pollinations node to your workflow
2. Select Generate Music operation
3. Select your Pollinations API credentials
4. Enter a description (e.g., "A calm piano melody with soft strings, ambient mood")
5. Set the duration in seconds (3-300)
6. Optionally enable Instrumental for music without vocals
7. Execute the node

The output will be a binary MP3 file. Use descriptive style terms rather than artist names for best results.

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
• Node.js version: 18.0.0 or later

Resources

• Pollinations API Documentation
• n8n Community Nodes Documentation
• Report Issues

License

MIT