Pollinations

io.github.pollinationsv1.0.0更新于 Sep 29, 2026

Access Pollinations models and API capabilities through agent tools.

已验证Streamable HTTP可网页运行AI & MLMedia & Design

概览

AI 生成的概览

托管的 Pollinations MCP 服务器，让助手通过一个 API 生成文本、图像、音频、视频、3D 模型和嵌入向量。

功能
通过 Streamable HTTP 将助手连接到 gen.pollinations.ai 上的托管 Pollinations 生成平台。助手可借此调用 Pollinations 模型完成文本与对话、图像生成与编辑、语音合成与转写、视频、3D 以及嵌入向量等任务。README 还介绍了托管代理、社区模型和兼容 OpenAI 的 API 接口。
适用场景
适合希望助手在不运行本地服务器的情况下，用 Pollinations 模型生成或编辑媒体与文本的场景。适用于需要由提示词生成图像、音频、视频、3D 或嵌入向量的工作流，以及已支持 Streamable HTTP MCP 的客户端。
运行要求
需要可访问网络的远程 MCP 端点 Pollinations API 密钥，通过 Authorization 请求头以 Bearer 形式发送；密钥在 Pollinations 注册页面创建。使用按 Pollen 积分计费。
安装前请注意
Authorization 请求头携带密钥；README 警告切勿在客户端代码、代码仓库或公开 URL 中暴露 sk_ 密钥。生成会消耗 Pollen 积分，调用可能产生费用。提示词和上传的媒体会发送到第三方托管服务，生成内容由外部模型提供方产出。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Pollinations，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "pollinations": {
      "type": "http",
      "url": "https://gen.pollinations.ai/mcp/pollinations"
    }
  }
}

README

[pollinations.ai]

Open-source AI for people who make things.

[Stars] [License] [Discord]

Website · Dashboard · Playground · API Docs · Discord

[!IMPORTANT] Model IDs are now standardized

Model IDs now follow publisher/model—for example, flux → black-forest-labs/flux.1-schnell. The model catalog uses the new IDs. Existing IDs remain supported as aliases in API requests.

Browse models and their aliases →

[Pixel art cozy hackerspace — robot at terminal, nomnom creature eating code, bee with glasses]

🆕 Recent Apps

NameDescriptionAuthor
💬 Roleplay AIHere is the complete, polished submission description tailored specifically for Roleplay App, ready to copy and paste for your submission! Roleplay App — Interactive AI Storytelling in Your Browser Br@arpitgoswami
🎬 GAANA BANANA# Gaana Banana AI se apna gaana banaiye — India ka personalized AI song maker. Naam likho, theme chuno, 1-2 minute mein vocals wala poora gaana ready. Perfect gift for birthdays, anniversaries, love,@NamanSoni78
🛠️ Calibrated DecisionsA visual playground for the Pollinations Jev typed-decisions API (POST /alpha/decisions). Write a decision state, build typed questions (choice with record options, score with ordered rungs, noul yes/@Jonakss
🖼️ Simple Image GeneratorA simple client-side image generator powered by Pollinations. Users sign in with their Pollinations account and generate images directly in the browser using their own Pollen balance. The app supports@xZeyrix
🖼️ image2gptGenerates images with openai/gpt-image-2. Visitors sign in with their own Pollinations account via OAuth (BYOP) and spend their own Pollen, so the app itself pays nothing. Includes a prompt box, three@18074148384
🎮 GATEKEEPERA 60-second arcade arena whose rules are written live by an AI. Before every run, a language model invents the terms of that run - which colour sustains you, which colour is fatal on contact, whether@Khuzaima3232
🛠️ ShouldIApplyShouldIApply tells job seekers their real, calibrated odds of passing a job's initial screen — before they waste the effort applying. Paste your resume and a job description. The app sends them to Pol@notsointresting
🖼️ Bees PollinationBees Pollination is a simple AI image generation app powered by Pollinations. Users connect their Pollinations account, enter a text prompt, and generate an image directly in the browser using the Pol@halimyassine
🖼️ Atelier — Pollinations Image StudioAtelier is a bilingual (English / 简体中文) image studio built on the Pollinations image API. Users write a prompt, generate with the live model catalog, refine results with reference-image editing, and k@xiaotian1171
💬 Oracle MystiqueOracle Mystique : AI-powered tarot reading with 3 cards (Past/Present/Future), AI-generated illustrations, interpretation in English. Full BYOP OAuth2 implementation.@stykdofus-ux

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-09-28 – 🤖 Frugal code-agent routing Call community/fadyabohamza-netizen/frugal to pick a low-cost, healthy model that can handle your context, images, and tools.
  • 2026-09-28 – 🎯 Code reviews with Prism cesus-agent/prism-code-review-router matches review requests to fast, balanced, or deep models based on the diff, tool needs, and available budget.
  • 2026-09-28 – 🔗 Polli connects to Codex and Claude Code Use polli harness codex or polli harness claude-code to route either tool through Pollinations, choose a model, and disconnect without changing your native login.
  • 2026-09-28 – ✨ Prompt agents can call your tools Give agents client-side functions alongside server-side MCP tools, then send the results back to continue the conversation. API docs
  • 2026-09-27 – 🎯 Apps can complete Quests Submit an app with an open Quest number. If the app is approved, the Quest closes and you can claim its Pollen reward.
  • 2026-09-27 – 🎨 Try image2gpt Prompt openai/gpt-image-2 from a web app using your Pollinations account and Pollen. Try it
  • 2026-09-27 – ✨ Generate images in your browser Simple Image Generator lets you sign in with Pollinations and create images using your Pollen balance. Try it
  • 2026-09-26 – 🎨 MiniMax H3 Max makes longer videos Generate 5-, 10-, or 15-second clips up to 1080p, with synchronized audio and options for start/end frames or reference media. Explore the API.
  • 2026-09-26 – 🎵 Gemini 3.8 finds its voice Generate WAV or PCM speech in 30 voices, with style instructions, using Flash or Flash Lite through the audio API.
  • 2026-09-26 – 🤖 GPT-6 Sol and Luna join the lineup Use both alongside Astra for vision, tools, structured output, streaming, and reasoning. Quest Pollen works too. See available models.

🌱 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.

🚀 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)
[Star History Chart]

🤖 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.

bash
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

bash
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

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

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.

Speech-to-text:

bash
curl 'https://gen.pollinations.ai/v1/audio/transcriptions' \  -H "Authorization: Bearer YOUR_API_KEY" \  -F [email protected] \  -F model=whisper-large-v3

Video Generation

bash
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

bash
curl 'https://gen.pollinations.ai/3d/a%20low-poly%20treasure%20chest?model=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

bash
curl 'https://gen.pollinations.ai/v1/embeddings' \  -H 'Content-Type: application/json' \  -H 'Authorization: Bearer YOUR_API_KEY' \  -d '{"model": "openai-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:

bash
npx @pollinations/cli gen image "cyberpunk city at night" --model flux --output city.pngnpx @pollinations/cli gen text "Explain quantum tunneling in one sentence"npx @pollinations/cli gen audio "Hello world" --voice nova --output speech.mp3npx @pollinations/cli gen video "a waterfall in slow motion" --duration 5 --output clip.mp4npx @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=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:

text
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

KeyPrefixUse CaseRate LimitsStatus
App Keypk_Browsers, mobile apps, public clientsBudget & permissions set at creationStable
Secretsk_Server-side onlyNo rate limitsStable

⚠️ 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 specific models. When creating a key at enter.pollinations.ai, 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 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:

javascript
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",  messages: [{ role: "user", content: "Hello!" }],});console.log(response.choices[0].message.content);

Python:

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",    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:

typescript
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"),  prompt: "Hello!",});console.log(text);

Streaming, image, and embedding examples: API docs → Vercel AI SDK.

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 — 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

🔮 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

来源：README.md，提交 37178fb

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v1.0.0最新Sep 29, 2026