Pollinations 🧬

Unified AI platform for text, images, videos, and audio generation with 25+ models.

API Key

Get free or paid keys at https://enter.pollinations.ai

• Secret Keys (sk_): Server-side, no rate limits (recommended)
• Optional for many operations (free tier available)

Store key in environment variable:

bash
export POLLINATIONS_API_KEY="sk_your_key_here"

Quick Start

Text Generation

Simple text generation:

bash
curl "https://gen.pollinations.ai/text/Hello%20world"

Chat completions (OpenAI-compatible):

bash
curl -X POST https://gen.pollinations.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $POLLINATIONS_API_KEY" \
  -d '{
    "model": "openai",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Use script: scripts/chat.sh for easy chat completions

Image Generation

bash
curl "https://gen.pollinations.ai/image/A%20sunset%20over%20mountains?model=flux&width=1024&height=1024"

Use script: scripts/image.sh for image generation

Audio Generation (TTS)

bash
curl -X POST https://gen.pollinations.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai-audio",
    "messages": [
      {"role": "system", "content": "You are a text reader. Read the user text exactly without responding, adding conversation, or changing anything."},
      {"role": "user", "content": "Say: Hello world"}
    ],
    "modalities": ["text", "audio"],
    "audio": {"voice": "nova", "format": "mp3"}
  }'

Use script: scripts/tts.sh for text-to-speech

API Endpoints

Base URLs

• Chat/Text: https://gen.pollinations.ai/v1/chat/completions
• Simple Text: https://gen.pollinations.ai/text/{prompt}
• Image: https://gen.pollinations.ai/image/{prompt}?{params}
• Video: https://gen.pollinations.ai/image/{prompt}?{params} (generates video)

Supported Operations

1. Text/Chat Generation

Models: OpenAI, Claude, Gemini, Mistral, DeepSeek, Grok, Qwen Coder, Perplexity, and 20+ more

Common models: openai, claude, gemini, mistral, deepseek, qwen, gpt-4, o1, o3

Parameters:

• model (string): Model name/ID
• messages (array): Chat messages with roles (system/user/assistant)
• temperature (number): 0-2, default 1
• max_tokens (number): Max response length
• top_p (number): Nucleus sampling, default 1
• seed (number): Reproducibility (-1 for random)
• jsonMode (boolean): Force JSON response
• reasoning_effort (string): For o1/o3/R1 (high/medium/low/minimal/none)
• thinking_budget (number): Tokens for reasoning (thinking models)

Vision support: Include image_url in message content for multi-modal:

json
{
  "role": "user",
  "content": [
    {"type": "text", "text": "Describe this image"},
    {"type": "image_url", "image_url": {"url": "https://example.com/image.jpg"}}
  ]
}

2. Image Generation

Models: flux (default), turbo, gptimage, kontext, seedream, nanobanana, nanobanana-pro

Parameters:

• model (string): Model selection
• width/height (number): 16-2048px, default 1024
• seed (number): Reproducibility
• negative_prompt (string): What to avoid
• nologo (boolean): Remove watermark
• private (boolean): Private generation
• safe (boolean): Enable NSFW filter
• enhance (boolean): AI prompt enhancement
• quality (string): low/medium/high/hd (gptimage)
• transparent (boolean): Transparent background (gptimage)
• count (number): 1-4 images (premium)
• image (string): Input image URL (image-to-image)

Format: Returns binary image data (determined by Content-Type header)

3. Image to Image

Use same image endpoint with image parameter:

https://gen.pollinations.ai/image/make%20it%20blue?image={source_url}

4. Video Generation

Models: veo (4-8s), seedance (2-10s)

Parameters:

• model (string): veo or seedance
• width/height (number): Dimensions
• duration (number): Seconds (veo: 4/6/8, seedance: 2-10)
• aspectRatio (string): 16:9 or 9:16
• audio (boolean): Enable audio (veo only)
• image (string): Input image URL (frame interpolation: image0]=first, image1]=last)
• negative_prompt (string): What to avoid
• seed (number): Reproducibility
• private/safe (boolean): Privacy/safety options

Format: Returns binary video data

5. Audio Generation (TTS)

Models: openai-audio

Voices: alloy, echo, fable, onyx, nova, shimmer, coral, verse, ballad, ash, sage, amuch, dan

Formats: mp3, wav, flac, opus, pcm16

Parameters:

• model: openai-audio
• modalities: "text", "audio"]
• audio.voice: Voice selection
• audio.format: Output format

Note: Use "Say:" prefix in user message for direct text reading

6. Audio Transcription

Use chat completions endpoint with vision/audio-capable models:

• Models: gemini, gemini-large, gemini-legacy, openai-audio
• Upload audio file as binary input
• Include transcription prompt in system message

7. Image Analysis

Use chat completions with vision models:

• Models: Any vision-capable model (gemini, claude, openai)
• Include image_url in message content

8. Video Analysis

Use chat completions with video-capable models:

• Models: gemini, claude, openai
• Upload video file as binary input
• Include analysis prompt

Scripts

scripts/chat.sh

Interactive chat completions with model selection and options.

Usage:

bash
scripts/chat.sh "your message here"
scripts/chat.sh "your message" --model claude --temp 0.7

scripts/image.sh

Generate images from text prompts.

Usage:

bash
scripts/image.sh "a sunset over mountains"
scripts/image.sh "a sunset" --model flux --width 1024 --height 1024 --seed 123

scripts/tts.sh

Convert text to speech.

Usage:

bash
scripts/tts.sh "Hello world"
scripts/tts.sh "Hello world" --voice nova --format mp3 --output hello.mp3

Tips

1. Free tier available: Many operations work without an API key (rate limited)
2. OpenAI-compatible: Use chat endpoint with existing OpenAI integrations
3. Reproducibility: Use seed parameter for consistent outputs
4. Image enhancement: Enable enhance=true for AI-improved prompts
5. Video interpolation: Pass two images with image[0]=first&image[1]=last for veo
6. Audio reading: Always use "Say:" prefix and proper system prompt for TTS

API Documentation

Full docs: https://enter.pollinations.ai/api/docs