Skip to content

Latest commit

ย 

History

11,945 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

pollinations.ai

Open-source AI for people who make things.

Stars License Discord

Website ยท Dashboard ยท Playground ยท Guides ยท API Docs ยท Discord

Pixel art cozy hackerspace โ€” robot at terminal, nomnom creature eating code, bee with glasses

๐Ÿ†• Recent Apps

Name Description Author
๐Ÿ› ๏ธ Pollinations Blocks Android extension for MIT App Inventor and Kodular: text, images, speech, AAC/M4A recording and transcription, and questions about picked images. Device sign-in lets users spend their own Pollen; no u @Saauf
๐Ÿ› ๏ธ Pollinations for MIT App Inventor One non-visible App Inventor extension (.aix) plus a ready sample project (.aia) that adds Pollinations to App Inventor apps (Kodular, Niotron and Android Builder take .aix files too). Everything is a @Drjacky
โœ๏ธ Summering text A static web application with an Arabic (RTL) interface that implements the Pollinations.ai BYOP OAuth 2.1 PKCE login flow entirely on the client side, in a single index.html file, without a backend s @fedaasawalmeh753-cmyk
๐Ÿ–ผ๏ธ Image-Captioning- A static web application with an Arabic (RTL) interface that implements the Pollinations.ai BYOP OAuth 2.1 PKCE login flow entirely on the client side, in a single index.html file, without a backend s @zeros372
๐ŸŽฎ The Basement Circuit A gritty, low-stakes text-to-fighter autobattler. Pollinations inks a complete fight card from a single line of text (up to 80 characters), equipping your contender with distinct personality traits, t @fisventurous
๐ŸŽฎ Tiny Fighter Arena Describe a fighter in one line and watch it battle. The AI designs the whole fighter (name, look, three moves, a quirk, stats and a fighting style), an image model draws its portrait, and it fights a @tomdacatto
๐ŸŽฎ Model Match A five-round guessing game: read one anonymous answer and pick which of four AI models wrote it. All 96 answers are pre-generated with the Pollinations API; no keys or API calls while you play. @patbing
๐ŸŽฌ Bit โ€” tech stories told by an AI agent Bit is a small robot mascot who tells true tech stories (security incidents, open-source projects, AI news) in short vertical videos for TikTok, Instagram and YouTube Shorts, in Italian and English. E @EnzinoBB
๐Ÿ’ฌ Colmena Colmena is a multi-model AI studio. Chat with GPT-6, DeepSeek, Grok, Kimi and 30+ Pollinations text models (streaming, Markdown, code highlighting) and use "Ask another model" to compare answers in pl @lotxo1
๐ŸŽฎ SPOT AI Real or AI? โ€” Spot the synthetic ๐Ÿ•ต๏ธ A browser guessing game built for Pollinations Quest #15725: It uses pollination ai different different image generation model Players are shown two images or two @07mrbeastofficial

Browse all apps โ†’

๐Ÿš€ Unified API

We've launched https://gen.pollinations.ai โ€” a single endpoint for all your AI generation needs: text, images, audio, video, 3D, embeddings โ€” all in one place.

What's Included

  • Unified endpoint โ€” single API at gen.pollinations.ai for all generation
  • Pollen credits โ€” simple pay-as-you-go system ($1 โ‰ˆ 1 Pollen)
  • All models, one place โ€” Flux, GPT, Claude, Gemini, Seedream, and more
  • API keys โ€” secret keys for model usage, app keys for tracking BYOP apps.
  • CLI โ€” npx @pollinations/cli for humans and AI agents (source)

Get started at enter.pollinations.ai and check out the API docs

๐Ÿ†• Latest News

  • 2026-10-15 โ€“ ๐Ÿš€ Media jobs without waiting Send Prefer: respond-async for image, video, audio or 3D generation, then check the job and download its result when it finishes. The SDK has async methods for the same flow. Read the API docs.
  • 2026-10-15 โ€“ ๐Ÿค– Models for typed decisions Ask Perplexity Decider V1.1 27B or Microsoft-Decision-1 to score fixed choices and return probabilities instead of prose. Both accept decision requests through /alpha/decisions. Browse models.
  • 2026-10-15 โ€“ ๐ŸŽต Sound effects for video Give mirelo/sfx-2.0 a video URL and a sound prompt to add synchronized effects to the clip. View the model.
  • 2026-10-15 โ€“ ๐Ÿ’ก Sandboxes keep their work New sandboxes default to pausing rather than deleting when their lease expires, so their files remain available. You can also name them and see estimated costs before choosing a template. Read the sandbox docs.
  • 2026-10-15 โ€“ ๐Ÿ“ฑ Pollinations in Android blocks Pollinations Blocks brings text, images, speech and transcription to MIT App Inventor and Kodular projects. View repo.
  • 2026-10-14 โ€“ ๐Ÿค– Lightning Text v2.1 Use inferenceport-ai/lightning-text-v2.1 with text or image input, JSON output, and tool calling. It requires paid Pollen. View the model.
  • 2026-10-14 โ€“ โœจ 3D in the SDK Generate binary 3D output with model3d(), discover 3D models with models("3d"), and get typed model status and speech word timings in the SDK alpha. Explore the SDK.
  • 2026-10-14 โ€“ ๐Ÿ”— React generation hooks The React SDK now has hooks for image, text, audio, video, and transcription generation, plus a streaming transport for Vercel AI SDKโ€™s useChat. Explore the SDK.
  • 2026-10-14 โ€“ ๐ŸŽฏ Guess the model Read an anonymous AI answer and guess which of four models wrote it. Five rounds, no API key needed. Try it.
  • 2026-10-14 โ€“ ๐ŸŽจ Make a tiny fighter Describe a fighter in one line, then see AI give it a portrait, moves, stats, and a battle. Try it.

๐ŸŒฑ Introduction

pollinations.ai is an open-source generative AI platform based in Berlin, powering 500+ community projects with accessible text, image, video, audio, 3D and embeddings generation APIs. We build in the open and keep AI accessible to everyoneโ€”thanks to our amazing supporters.

Star History Chart

๐Ÿš€ Key Features

  • ๐Ÿ”“ 100% Open Source โ€” code, decisions, roadmap all public
  • ๐Ÿค Community-Built โ€” 500+ projects already using our APIs
  • ๐ŸŒฑ Pollen Quests โ€” earn Pollen by completing Quests
  • ๐Ÿ–ผ๏ธ Image Generation โ€” Text-to-image and image editing
  • ๐Ÿ“ Text Generation โ€” Chat, reasoning, vision, function calling, structured outputs
  • ๐ŸŽฌ Video Generation โ€” Text-to-video and image-to-video
  • ๐ŸŽต Audio โ€” Text-to-speech and speech-to-text
  • ๐ŸงŠ 3D Generation โ€” Text-to-3D and image-to-3D
  • ๐ŸŽ™๏ธ Real-time API โ€” OpenAI-compatible WebSocket for streaming conversations
  • ๐Ÿ”ข Embeddings Creation โ€” Semantic search, retrieval, similarity matching
  • ๐Ÿค– Managed Agents โ€” Turn a prompt, base model, and optional Pollinations tools into a reusable model
  • ๐ŸŽฃ Easy-to-use Packages (Packages)

Guides

Guide Purpose
Connect User Wallets (BYOP) Let users pay with their own Pollen
Publish an Agent Publish a hosted agent
Publish a Model Connect your model endpoint
Sandboxes Run code in a virtual machine
Coding Harnesses Connect a coding assistant
MCP Servers Give agents access to tools
CLI Use Pollinations from a terminal

๐Ÿค– Managed Agents

Build a reusable text agent without hosting an agent server. Choose a system prompt and base model, optionally give it Pollinations tools, then call it through the same OpenAI-compatible API as any other model.

  • Private or public โ€” keep an agent owner-only or publish it after receiving community publisher access.
  • Normal model API โ€” call a registered agent by its owner/agent-name model ID.
  • Dashboard, CLI, or API โ€” manage agents in My Models, with polli agents, or through /account/agents.

See Publish an Agent for setup and billing behavior.

๐Ÿ› ๏ธ Coding Harnesses

Run tools such as Bloom CLI, DeepSeek Harness, Hermes Agent, OpenCode, Pi, Prime Agent, and tgpt on Pollinations models. polli harness edits the tool's own config so it calls Pollinations with a dedicated key, and restores it on off.

npx @pollinations/cli harness dsh on

See Coding Harnesses for supported harnesses and how to add one.

๐Ÿงฉ Community Models

Community members connect their own OpenAI-compatible text, image, image-editing, and speech-to-text endpoints to Pollinations.

  • Host your own model โ€” follow Publish a Model to test and register an upstream endpoint, then keep it private or publish it to the catalog.
  • Automatic fallback routing โ€” nominate up to three compatible backup models so generations keep moving when an upstream model goes down.
  • Discover and monitor โ€” browse community models via gen.pollinations.ai/v1/models and watch live health and community leaderboards at model-monitor.pollinations.ai.

For billing details when building apps on top, see Connect User Wallets.

๐Ÿš€ Getting Started

Ask DeepWiki

Quick Start (3 Steps)

1๏ธโƒฃ Get your API key
Sign up at enter.pollinations.ai to generate your key.

2๏ธโƒฃ Choose what you want to generate
Pollinations supports:

  • ๐Ÿ–ผ Images
  • ๐Ÿ“ Text
  • ๐Ÿ”Š Audio
  • ๐ŸŽฌ Video
  • ๐ŸงŠ 3D
  • ๐Ÿ”ข Embeddings

3๏ธโƒฃ Make your first request
Use one of the examples below to generate your first AI output in seconds.

Image Generation

curl -H "Authorization: Bearer YOUR_API_KEY" 'https://gen.pollinations.ai/image/a%20beautiful%20sunset' -o image.jpg

Or visit pollinations.ai/play for an interactive experience.

Text Generation

curl 'https://gen.pollinations.ai/text/Hello%20world?key=YOUR_API_KEY'

Audio Generation

Simple GET endpoint:

curl 'https://gen.pollinations.ai/audio/Hello%20from%20Pollinations?voice=nova&key=YOUR_API_KEY' -o speech.mp3

OpenAI TTS compatible:

curl 'https://gen.pollinations.ai/v1/audio/speech' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{"model": "openai/tts-1", "input": "Hello from Pollinations!", "voice": "nova"}' \
  -o speech.mp3

Available voices: alloy, echo, fable, onyx, nova, shimmer, plus 30+ ElevenLabs voices.

Speech-to-text:

curl 'https://gen.pollinations.ai/v1/audio/transcriptions' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F file=@audio.mp3 \
  -F model=openai/whisper-large-v3

Video Generation

curl 'https://gen.pollinations.ai/video/a%20sunset%20timelapse%20over%20the%20ocean?key=YOUR_API_KEY' -o video.mp4

Use duration to set video length, aspectRatio for orientation, and image[0]/image[1] to pass start/end reference frames. See available video models and capabilities at gen.pollinations.ai/video/models.

3D Generation

curl 'https://gen.pollinations.ai/3d/a%20low-poly%20treasure%20chest?model=microsoft/trellis-2&resolution=low&key=YOUR_API_KEY&image=IMAGE_URL' -o model.glb

Pass reference image URL(s) via the image parameter for image-to-3D models (put image= last in the URL, or URL-encode it). See available 3D models at gen.pollinations.ai/3d/models.

Embeddings

curl 'https://gen.pollinations.ai/v1/embeddings' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{"model": "openai/text-embedding-3-small", "input": "Hello world!"}'

Pass a string or an array of up to 32 strings (text or multimodal content parts). See available embedding models at gen.pollinations.ai/embeddings/models.

Pollinations CLI

Generate text, images, audio, video, and more right from your terminal:

npx @pollinations/cli gen image "cyberpunk city at night" --model black-forest-labs/flux.1-schnell --output city.png
npx @pollinations/cli gen text "Explain quantum tunneling in one sentence"
npx @pollinations/cli gen audio "Hello world" --voice nova --output speech.mp3
npx @pollinations/cli gen video "a waterfall in slow motion" --duration 5 --output clip.mp4
npx @pollinations/cli gen transcribe speech.mp3

Install globally and use the shorter polli command: npm install -g @pollinations/cli. Run polli models to list models, polli auth login to authenticate, and polli docs for the full API reference in your terminal.

Real-time API

Stream AI responses over an OpenAI-compatible WebSocket:

wss://gen.pollinations.ai/v1/realtime?model=openai/gpt-realtime-2.1&key=pk_YOUR_API_KEY

Browser clients pass the key as a query parameter (?key=); server clients can use the Authorization: Bearer header instead.

MCP Servers

Connect Streamable HTTP clients to the hosted Pollinations MCP server:

https://gen.pollinations.ai/mcp/pollinations

Send your Pollinations API key as an Authorization: Bearer header. See the MCP Servers documentation for the full hosted catalog.

๐Ÿ” Authentication

Get your API key at enter.pollinations.ai

Key Types

Key Prefix Use Case Rate Limits Status
App Key pk_ Browsers, mobile apps, public clients Budget & permissions set at creation Stable
Secret sk_ Server-side only No rate limits Stable

โš ๏ธ Never expose sk_ keys in client-side code, git repos, or public URLs

๐Ÿ’ก Building an app? Use Connect User Wallets โ€” users pay for their own usage, you pay $0

Model Restrictions

Each API key can be scoped to model categories or specific models. When creating a key at enter.pollinations.ai, you can:

  • Allow all models โ€” key works with any available model
  • Restrict to categories โ€” e.g. only image, or image and text. A key allows every model in its categories, including models added later
  • Restrict to specific models โ€” through the API or polli keys update <id> --models black-forest-labs/flux.1-schnell tongyi-mai/z-image-turbo; a model ID allows only that model

Usage

curl 'https://gen.pollinations.ai/image/a%20cat?key=YOUR_KEY'

Environment variable (best practice):

export POLLINATIONS_API_KEY=sk_...

See full API docs for detailed authentication information.

๐Ÿ–ฅ๏ธ How to Use

Web Interface

Our web interface is user-friendly and doesn't require any technical knowledge. Simply visit https://pollinations.ai and start creating!

Here are some examples of what you can generate:

Pixel art robot and bee in a cozy digital garden โ€” Stardew Valley vibes

Robot holding generated image saying I CAN SEE, nomnom creature eating prompt text

๐Ÿ› ๏ธ Integration

SDK

Check out our Pollinations SDK for Node.js, browser, and React integration.

OpenAI SDK Compatibility

The API is OpenAI-compatible, so the official OpenAI SDKs work out of the box โ€” just point them at https://gen.pollinations.ai/v1.

Node.js:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://gen.pollinations.ai/v1",
  apiKey: "YOUR_API_KEY",
});

const response = await client.chat.completions.create({
  model: "openai/gpt-5.4-nano",
  messages: [{ role: "user", content: "Hello!" }],
});
console.log(response.choices[0].message.content);

Python:

from openai import OpenAI

client = OpenAI(base_url="https://gen.pollinations.ai/v1", api_key="YOUR_API_KEY")

response = client.chat.completions.create(
    model="openai/gpt-5.4-nano",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(response.choices[0].message.content)

Other OpenAI SDKs work too: Go, Java, .NET, Rust (async-openai, community) โ€” plus compatible frameworks like Vercel AI SDK.

Vercel AI SDK:

import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
import { generateText } from "ai";

const pollinations = createOpenAICompatible({
  name: "pollinations",
  baseURL: "https://gen.pollinations.ai/v1",
  apiKey: "YOUR_API_KEY",
});

const { text } = await generateText({
  model: pollinations.chatModel("openai/gpt-5.4-nano"),
  prompt: "Hello!",
});
console.log(text);

Streaming, image, and embedding examples: API docs โ†’ Vercel AI SDK.

Architecture

%%{init: {'theme': 'dark', 'themeVariables': { 'background': '#1a1a1a', 'primaryColor': '#2a2a2a', 'primaryBorderColor': '#555555', 'primaryTextColor': '#eeeeee', 'lineColor': '#00e5ff', 'clusterBkg': 'transparent', 'clusterBorder': '#888888', 'fontSize': '13px', 'fontFamily': 'Inter, system-ui, sans-serif'}}}%%

graph LR
    subgraph CLIENTS["Clients / Apps"]
        Q[Bots - Discord, Telegram, WhatsApp]
        N[30+ Mobile and Web Apps]
        A[pollinations.ai Web Frontend]
        R[AI Agents - Qwen, Sillytavern, ...]
        AI[AI Assistants - Claude]
        MCP[MCP Server]
    end

    AI --> MCP
    Q --> GEN
    N --> GEN
    A --> GEN
    R --> GEN
    MCP --> GEN

    GEN["gen.pollinations.ai โ€” Edge Router + Generation Worker"]:::cfWorker -->|auth and billing| ENTER["enter.pollinations.ai โ€” Auth Gateway + Billing"]:::cfWorker

    GEN --> IMG["Image โ€” gen Worker dispatch to providers / GPU backends"]:::cfWorkerLight
    IMG --> D["Flux, Z-Image, Seedream, ... โ€” GPU VMs"]:::gpuNode

    GEN --> TXT["Text โ€” Portkey multi-provider"]:::provider
    GEN --> VID["Video โ€” Wan / Veo / Seedance"]:::provider
    GEN --> AUD["Audio โ€” ElevenLabs / OVH (Whisper)"]:::provider

    style CLIENTS fill:none,stroke:#888,stroke-width:2px,stroke-dasharray: 5 5

    linkStyle default stroke-width:3px,stroke:#00E5FF

    classDef cfWorker fill:#E65100,color:#fff,stroke:#FFB300,stroke-width:2px,font-weight:bold
    classDef cfWorkerLight fill:#BF360C,color:#fff,stroke:#FFB300,stroke-width:1px
    classDef gpuNode fill:#064E3B,stroke:#34D399,color:#ECFDF5,stroke-width:2px
    classDef provider fill:#1E3A8A,stroke:#60A5FA,color:#EFF6FF,stroke-width:1px
Loading

๐Ÿ”ฎ Future Developments

We're constantly exploring new ways to push the boundaries of AI-driven content creation. Some areas we're excited about include:

  • Digital Twins: Creating interactive AI-driven avatars
  • Music Video Generation: Combining AI-generated visuals with music for unique video experiences
  • Real-time AI-driven Visual Experiences: Projects like our Dreamachine, which create immersive, personalized visual journeys

๐ŸŒ Our Vision

pollinations.ai envisions a future where AI technology is:

  • Open & Accessible: We believe AI should be available to everyone โ€” earn Pollen by contributing, no credit card required

  • Transparent & Ethical: Our open-source approach ensures transparency in how our models work and behave

  • Community-Driven: We're building a platform where developers, creators, and AI enthusiasts can collaborate and innovate

  • Interconnected: We're creating an ecosystem where AI services can seamlessly work together, fostering innovation through composability

  • Evolving: We embrace the rapid evolution of AI technology while maintaining our commitment to openness and accessibility

We're committed to developing AI technology that serves humanity while respecting ethical boundaries and promoting responsible innovation. Join us in shaping the future of AI.

๐Ÿค Community and Development

We believe in community-driven development. You can contribute to pollinations.ai in several ways:

  1. Coding Assistant: The easiest way to contribute! Just create a GitHub issue describing the feature you'd like to see implemented. The Polli assistant will analyze and implement it directly! No coding required - just describe what you want.

  2. Project Submissions: Have you built something with pollinations.ai? Use our app submission template to share it with the community and get it featured in our README.

  3. Feature Requests & Bug Reports: Have an idea or found a bug? Open an issue and let us know. Our team and the Polli assistant will review it.

  4. Community Engagement: Join our vibrant Discord community to:

    • Share your creations
    • Get support and help others
    • Collaborate with fellow AI enthusiasts
    • Discuss feature ideas before creating issues

For any questions or support, please visit our Discord channel or create an issue on our GitHub repository.

๐Ÿ—‚๏ธ Project Structure

Our codebase is organized into several key folders, each serving a specific purpose in the pollinations.ai ecosystem:

  • pollinations.ai/: The main React application for the Pollinations.ai website.

  • gen.pollinations.ai/: Cloudflare Worker for API routing, auth handoff, text generation, and caching.

  • enter.pollinations.ai/: Auth gateway and billing โ€” API keys, Pollen credits, and pack checkout.

  • shared/: Auth, model registries, IP queue, and utilities shared across the services.

  • apps/: Applications maintained in this repository.

  • operations/: Internal dashboards, monitoring, economics, and infrastructure, including the GPU fleet.

  • media.pollinations.ai/: Media upload service โ€” upload files and get a URL to use with Pollinations models, with public tag galleries.

  • operations/social/: Automated social media pipeline (X, LinkedIn, Instagram, Reddit, Discord).

  • packages/polli-cli/: The Pollinations CLI โ€” for humans, AI agents, and everything in between.

  • packages/sdk/: SDK NPM library with pollinations ready functions for Pollinations.ai.

  • packages/mcp/: Model Context Protocol (MCP) server for AI assistants like Claude to generate images directly.

  • opencode-pollinations-plugin: This is opencode-pollinations-plugin, a plugin for OpenCode that integrates Pollinations.ai's inference capabilities directly into the OpenCode environment, built by our community member @fkom13.

This structure encompasses the frontend website, backend services for image and text generation, and integrations like the Discord bot and MCP server, providing a comprehensive framework for the pollinations.ai platform.

For development setup and environment management, see DEVELOP.md.

๐Ÿข Supported By

pollinations.ai is proud to be supported by:

Pixel art garden shelf โ€” supporter plants in labeled pots, robot watering, bee with watering can

๐Ÿ’š Support Us

The best way to support pollinations.ai is by using our product! Get your API key and start building at enter.pollinations.ai.

๐Ÿ“ฃ Stay Connected

Status ยท News & FAQ ยท ๐• Twitter ยท Instagram ยท LinkedIn ยท Facebook ยท Reddit ยท YouTube

๐Ÿ“œ License

pollinations.ai is open-source software licensed under the MIT license.


Made with โค๏ธ by the pollinations.ai team

Releases

Packages

Used by

Contributors

Languages