--- slug: "pollinations-pollinations" source_type: "readme" source_url: "https://cdn.jsdelivr.net/gh/pollinations/pollinations@main/README.md" repo: "https://github.com/pollinations/pollinations" source_file: "README.md" branch: "main" ---
pollinations.ai

Open-source AI for people who make things.

[![Stars](https://img.shields.io/github/stars/pollinations/pollinations?style=flat-square&logo=github)](https://github.com/pollinations/pollinations/stargazers) [![License](https://img.shields.io/github/license/pollinations/pollinations?style=flat-square)](LICENSE) [![Discord](https://img.shields.io/discord/885844321461485618?style=flat-square&logo=discord&label=Discord&color=5865F2)](https://discord.gg/pollinations-ai-885844321461485618) [Website](https://pollinations.ai) ยท [Dashboard](https://enter.pollinations.ai) ยท [API Docs](https://github.com/pollinations/pollinations/blob/HEAD/APIDOCS.md) ยท [Discord](https://discord.gg/pollinations-ai-885844321461485618)

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

## ๐Ÿ†• Recent Apps | Name | Description | Author | |------|-------------|--------| | [๐Ÿ’ฌ Le petit AI](https://le-petit-seven.vercel.app) | Open https://le-petit-seven.vercel.app/ to use Le petit AI. | [@JustLookingSoftwares](https://github.com/JustLookingSoftwares) | | [๐Ÿ’ฌ Lumina Chat](https://lumina.magnified.cc) | Lumina is an AI chat application designed to provide a seamless and flexible interface for interacting with large language models. The app includes built-in support for Pollinations.AI as a default pr | [@kokofixcomputers](https://github.com/kokofixcomputers) | | [๐Ÿ’ฌ MyEntMap](https://mymap.qvlit.com) | MyEntMap is a multilingual (zh/vi/en, auto-detected) food & entertainment map for Ho Chi Minh City. It uses the Pollinations API in three ways: (1) auto-generating Ghibli-watercolor store photos with | [@yukyotsai](https://github.com/yukyotsai) | | [๐Ÿ–ผ๏ธ Vtrace](https://vtrace-two.vercel.app) | raster image to vector SVG | [@ifankang](https://github.com/ifankang) | | [โœ๏ธ StoryStudio](https://eiigen.github.io/storystudio-app) | AI StoryStudio โ€” A web-based storybook generator powered by Pollinations.ai. Enter any theme and get a fully illustrated multi-page story with AI-generated text, images, and optional audio narration. | [@eiigen](https://github.com/eiigen) | | [๐Ÿ› ๏ธ AI Health Studio](https://kreggscode.github.io/health-analyzer-ai) | AI Health Studio is an AI-powered health and wellness web app that uses Pollinations AI APIs at its core: - **Chat Completions API** (POST gen.pollinations.ai/v1/chat/completions): Generates personali | [@kreggscode](https://github.com/kreggscode) | | [๐Ÿ› ๏ธ Pollinations AI Studio](https://sashafilipov.github.io/pollinations-ai-studio) | Multimodal workspace for Pollinations.ai ะฒะ‚โ€ chat with GPT/Claude/Gemini/DeepSeek via gen.pollinations.ai/v1/chat/completions , generate images via gen.pollinations.ai/image/{prompt} (Flux, Turbo, GPT | [@sashafilipov](https://github.com/sashafilipov) | | [๐ŸŽฌ Driftpod.fm](https://driftpod.fm) | Press play for endless discovery of podcasts. Users tailor their experience by adding favorite podcasts, liking and disliking episodes, and the recommendation engine gets episode metadata (summaries, | [@alexander](https://github.com/alexander) | | [๐Ÿ–ผ๏ธ Anime Forge](https://animeforge-k4ltm64.public.builtwithrocket.new) | Anime Forge is an AI-driven anime character design web app powered by Pollinations API for text and image generation. | [@masreamro496-ship-it](https://github.com/masreamro496-ship-it) | | [๐Ÿ’ฌ Arika](https://arika.hizumi.in) | Arika provides a conversational AI experience designed to feel more human and less robotic. | [@02th](https://github.com/02th) | [Browse all apps โ†’](https://github.com/pollinations/pollinations/blob/HEAD/apps/GREENHOUSE.md) ## ๐Ÿš€ New Unified API โ€” Now Live 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 New - **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](https://github.com/pollinations/pollinations/tree/HEAD/packages/polli-cli)) > Get started at [enter.pollinations.ai](https://enter.pollinations.ai) and check out the [API docs](https://gen.pollinations.ai/docs) ## ๐Ÿ†• Latest News - **2026-07-29** โ€“ **๐Ÿš€ Polli Agent** Send one OpenAI-compatible streaming request and get coordinated text, images, audio, video, web search, and media stitching back. One prompt, many petals. [Try it](https://polli.pollinations.ai) - **2026-07-29** โ€“ **โœจ Agent Run Tokens** Community agents can now use short-lived delegated tokens to generate on a callerโ€™s Pollen budget without ever handling their API key. Tiny keys, fewer ways to spill honey. [API Docs](https://gen.pollinations.ai/docs) - **2026-07-28** โ€“ **๐ŸŽฌ Wan gets more runway** Long Wan 2.7 text-to-video and image-to-video generations now have up to 15 minutes to finish. The machine is permitted to think in frames. - **2026-07-28** โ€“ **โœจ Story seeds, illustrated** Turn a theme into a multi-page story with AI-written text, images, and optional narration. [Try it](https://eiigen.github.io/storystudio-app) - **2026-07-28** โ€“ **๐ŸŽจ Pixels, meet paths** Convert raster artwork into scalable SVG paths for reuse at any size. [Try it](https://vtrace-two.vercel.app) - **2026-07-28** โ€“ **๐Ÿš€ A studio grew in the garden** One community workspace for switching between GPT, Claude, Gemini, and DeepSeek, then generating images with Pollinations. [Try it](https://sashafilipov.github.io/pollinations-ai-studio) - **2026-07-27** โ€“ **๐ŸŽจ Community image edits** Validated community models can now edit reference images through the OpenAI-compatible `/v1/images/edits` endpoint. Send pixels in; receive altered pixels back. [API Docs](https://gen.pollinations.ai/docs) - **2026-07-27** โ€“ **๐Ÿค– NVIDIA Nemotron 3 Ultra** `nemotron` is now available for 262K-context reasoning, tool use, and structured JSON through the standard text API. [Try it](https://pollinations.ai/play) - **2026-07-27** โ€“ **โšก More reliable Z-Image capacity** New GPU workers now join production only after proving they are healthy; the canary handled 102/102 requests with a 4.69s p50. - **2026-07-26** โ€“ **๐ŸŽต ElevenLabs dialogue** Generate multi-speaker scenes with up to 10 voices and 25 turns through `POST /v1/audio/dialogue`. The hive has learned to hold a conversation. [API Docs](https://gen.pollinations.ai/docs) --- ## ๐ŸŒฑ Introduction [pollinations.ai](https://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. ## ๐Ÿš€ 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 (in alpha) - ๐Ÿ–ผ๏ธ **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 - ๐Ÿ”ข **Embeddings Creation** โ€” Semantic search, retrieval, similarity matching - ๐ŸŽฃ **_Easy-to-use Packages_** ([Packages](https://github.com/pollinations/pollinations/tree/HEAD/packages/)) Star History Chart ### Quick Start (3 Steps) 1๏ธโƒฃ **Get your API key** Sign up at [enter.pollinations.ai](https://enter.pollinations.ai/keys) 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. ## ๐Ÿš€ Getting Started [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/pollinations/pollinations) ### Image Generation ```bash curl 'https://gen.pollinations.ai/image/a%20beautiful%20sunset' -o image.jpg ``` Or visit [pollinations.ai](https://pollinations.ai) for an interactive experience. ### Text Generation ```bash curl 'https://gen.pollinations.ai/text/Hello%20world' ``` ### Audio Generation **Simple GET endpoint:** ```bash curl 'https://gen.pollinations.ai/audio/Hello%20from%20Pollinations?voice=nova&key=YOUR_API_KEY' -o speech.mp3 ``` **OpenAI TTS compatible:** ```bash curl 'https://gen.pollinations.ai/v1/audio/speech' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_API_KEY' \ -d '{"model": "tts-1", "input": "Hello from Pollinations!", "voice": "nova"}' \ -o speech.mp3 ``` Available voices: `alloy`, `echo`, `fable`, `onyx`, `nova`, `shimmer`, plus [30+ ElevenLabs voices](https://gen.pollinations.ai/docs). ### MCP Server for AI Assistants Our MCP (Model Context Protocol) server enables AI assistants like Claude to generate images and audio directly. [Learn more](https://github.com/pollinations/pollinations/blob/HEAD/packages/mcp/README.md) #### Configuration Add this to your MCP client configuration: ```json { "mcpServers": { "pollinations": { "command": "npx", "args": ["@pollinations/mcp"] } } } ``` ### Run with npx (no installation required) ```bash npx @pollinations/mcp ``` Community alternatives like [MCPollinations](https://github.com/pinkpixel-dev/MCPollinations) and [Sequa MCP Server](https://mcp.sequa.ai/v1/pollinations/contribute) are also available. AI assistants can: - Generate images from text descriptions - Create text-to-speech audio with various voice options - Play audio responses through the system speakers - Access all pollinations.ai models and services - List available models, voices, and capabilities **For more advanced usage, check out our [API documentation](https://github.com/pollinations/pollinations/blob/HEAD/APIDOCS.md).** ## ๐Ÿ” Authentication Get your API key at [enter.pollinations.ai](https://enter.pollinations.ai/keys) ### 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 [Bring Your Own Pollen](https://github.com/pollinations/pollinations/blob/HEAD/BRING_YOUR_OWN_POLLEN.md) โ€” users pay for their own usage, you pay $0 ### Model Restrictions Each API key can be scoped to specific models. When creating a key at [enter.pollinations.ai](https://enter.pollinations.ai/keys), you can: - **Allow all models** โ€” key works with any available model - **Restrict to specific models** โ€” select exactly which models the key can access (e.g., only `flux` and `openai`, or just `gptimage-large`) ### Usage ```bash curl 'https://gen.pollinations.ai/image/a%20cat?key=YOUR_KEY' ``` **Environment variable (best practice):** ```bash export POLLINATIONS_API_KEY=sk_... ``` See [full API docs](https://github.com/pollinations/pollinations/blob/HEAD/APIDOCS.md) 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](https://pollinations.ai) and start creating! ### API Use our API directly in your browser or applications: https://pollinations.ai/p/a_cozy_pixel_art_robot_and_bee_in_a_digital_garden_8-bit_warm_stardew_valley_vibes Replace the description with your own, and you'll get a unique image based on your words! Here's an example of a generated image:

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

## ๐ŸŽจ Examples ### Image Generation Python code to download the generated image: import requests def download_image(prompt): url = f"https://pollinations.ai/p/{prompt}" response = requests.get(url) with open('generated_image.jpg', 'wb') as file: file.write(response.content) print('Image downloaded!') download_image("a_cozy_pixel_art_robot_and_bee_in_a_digital_garden_8-bit_warm_stardew_valley_vibes") ### Text Generation To generate text: https://gen.pollinations.ai/text/What%20is%20artificial%20intelligence? ### Audio Generation Generate speech from text: https://gen.pollinations.ai/audio/Hello%20from%20Pollinations?voice=alloy&key=YOUR_API_KEY Or use the OpenAI TTS-compatible endpoint: ```bash curl 'https://gen.pollinations.ai/v1/audio/speech' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_API_KEY' \ -d '{"model": "tts-1", "input": "Hello from Pollinations!", "voice": "alloy"}' \ -o speech.mp3 ``` ## ๐Ÿ› ๏ธ Integration ### SDK Check out our [Pollinations SDK](https://github.com/pollinations/pollinations/blob/HEAD/packages/sdk/README.md) for Node.js, browser, and React integration. ## Architecture ```mermaid %%{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"]:::cfWorker --> ENTER["enter.pollinations.ai Gateway"]:::cfWorker ENTER --> IMG["Image Service"]:::ec2 ENTER --> AUD["Audio Service"]:::ec2 IMG --> CF["Cloudflare Worker with R2 Cache"]:::cfWorkerLight CF --> B["image-origin.pollinations.ai"]:::ec2 B --> D["FLUX / GPT Image / Seedream - GPU VMs"]:::gpuNode AUD --> EL["ElevenLabs TTS API"]:::provider GEN --> SC["Scaleway API"]:::provider GEN --> DS["Deepseek API"]:::provider GEN --> G["Azure-hosted LLMs"]:::provider GEN --> CFM["Cloudflare AI"]:::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 ec2 fill:#1F2937,color:#fff,stroke:#F59E0B,stroke-width:2px classDef gpuNode fill:#064E3B,stroke:#34D399,color:#ECFDF5,stroke-width:2px classDef provider fill:#1E3A8A,stroke:#60A5FA,color:#EFF6FF,stroke-width:1px ``` ## ๐Ÿ”ฎ 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](https://github.com/pollinations/pollinations/issues/new) describing the feature you'd like to see implemented. The [MentatBot AI assistant](https://mentat.ai/) 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](https://github.com/pollinations/pollinations/issues/new?template=app-submission.yml) 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](https://github.com/pollinations/pollinations/issues/new) and let us know. Our team and the MentatBot assistant will review it. 4. **Community Engagement**: Join our vibrant [Discord community](https://discord.gg/pollinations-ai-885844321461485618) 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](https://discord.gg/pollinations-ai-885844321461485618) or create an issue on our [GitHub repository](https://github.com/pollinations/pollinations). ## ๐Ÿ—‚๏ธ Project Structure Our codebase is organized into several key folders, each serving a specific purpose in the pollinations.ai ecosystem: - [`pollinations.ai/`](https://github.com/pollinations/pollinations/tree/HEAD/app/): The main React application for the Pollinations.ai website. - [`image.pollinations.ai/`](https://github.com/pollinations/pollinations/tree/HEAD/image.pollinations.ai/): Backend service for image generation and caching with Cloudflare Workers and R2 storage. - [`gen.pollinations.ai/`](https://github.com/pollinations/pollinations/tree/HEAD/gen.pollinations.ai/): Cloudflare Worker for API routing, auth handoff, text generation, and caching. - [`packages/polli-cli/`](https://github.com/pollinations/pollinations/tree/HEAD/packages/polli-cli/): The Pollinations CLI โ€” for humans, AI agents, and everything in between. - [`packages/sdk/`](https://github.com/pollinations/pollinations/tree/HEAD/packages/sdk/): SDK NPM library with pollinations ready functions for Pollinations.ai. - [`packages/mcp/`](https://github.com/pollinations/pollinations/tree/HEAD/packages/mcp/): Model Context Protocol (MCP) server for AI assistants like Claude to generate images directly. - [`opencode-pollinations-plugin`](https://github.com/fkom13/opencode-pollinations-plugin): This is `open-code-pollinations-plugin`, a plugin for OpenCode that integrates Pollinations.ai's inference capabilities directly into the OpenCode environment, built by our community member [@fkom13](https://github.com/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](https://github.com/pollinations/pollinations/blob/HEAD/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

- [Perplexity AI](https://www.perplexity.ai/): AI-powered search and conversational answer engine - [AWS Activate](https://aws.amazon.com/): GPU Cloud Credits - [io.net](https://io.net/): Decentralized GPU network for AI compute - [BytePlus](https://www.byteplus.com/): Official ByteDance cloud services and AI solutions - [Google Cloud for Startups](https://cloud.google.com/): GPU Cloud Credits - [NVIDIA Inception](https://www.nvidia.com/en-us/deep-learning-ai/startups/): AI startup support - [Azure (MS for Startups)](https://azure.microsoft.com/): OpenAI credits - [Cloudflare](https://developers.cloudflare.com/workers-ai/): Put the connectivity cloud to work for you. - [Scaleway](https://www.scaleway.com/): Europe's empowering cloud provider - [Modal](https://modal.com/): High-performance AI infrastructure - [Nebius](https://nebius.com/): AI-optimized cloud infrastructure with NVIDIA GPU clusters ## ๐Ÿ’š 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](https://enter.pollinations.ai/keys)**. ## ๐Ÿ“ฃ Stay Connected [News & FAQ](https://enter.pollinations.ai/news) ยท [๐• Twitter](https://twitter.com/pollinations_ai) ยท [Instagram](https://instagram.com/pollinations_ai) ยท [LinkedIn](https://www.linkedin.com/company/pollinations-ai) ยท [Facebook](https://facebook.com/pollinations) ยท [Reddit](https://www.reddit.com/r/pollinations_ai/) ยท [YouTube](https://www.youtube.com/c/pollinations) ## ๐Ÿ“œ License pollinations.ai is open-source software licensed under the [MIT license](https://github.com/pollinations/pollinations/tree/HEAD/LICENSE). --- Made with โค๏ธ by the pollinations.ai team