Merge 4de5f3679d into 4583f88626
This commit is contained in:
Jason Brashear (AKA SEM)
GitHub
commit
7a2977fdde
197
docs/providers/pollinations.md
Normal file
197
docs/providers/pollinations.md
Normal file
@ -0,0 +1,197 @@
|
||||
---
|
||||
summary: "Use Pollinations.ai unified Gen-AI platform with Clawdbot"
|
||||
read_when:
|
||||
- You want to use Pollinations.ai models in Clawdbot
|
||||
- You need access to multiple AI providers through a single API
|
||||
---
|
||||
# Pollinations
|
||||
|
||||
[Pollinations.ai](https://pollinations.ai) is an open-source Gen-AI platform that provides a unified API gateway for accessing multiple AI models including GPT-5, Claude, Gemini, Flux (image generation), and more. It uses an OpenAI-compatible API format, making it easy to integrate with Clawdbot.
|
||||
|
||||
## Features
|
||||
|
||||
- **Unified API** — Access GPT-5, Claude, Gemini, Grok, and more through a single endpoint
|
||||
- **Image Generation** — Flux, GPT Image, Seedream, and other image models
|
||||
- **Video Generation** — Text-to-video with Seedance and Veo (alpha)
|
||||
- **Audio** — Text-to-speech, speech-to-text, and voice options
|
||||
- **Pay-as-you-go** — Simple Pollen credits system ($1 ≈ 1 Pollen)
|
||||
- **OpenAI-compatible** — Works with existing OpenAI API clients
|
||||
|
||||
## Getting your API key
|
||||
|
||||
1. Visit [enter.pollinations.ai](https://enter.pollinations.ai)
|
||||
2. Log in with your GitHub account
|
||||
3. Create an API key from the dashboard
|
||||
4. Choose between:
|
||||
- **Publishable keys (pk_)** — Frontend use, with rate limits
|
||||
- **Secret keys (sk_)** — Server-side only, no rate limits (keep secret!)
|
||||
|
||||
You can scope each API key to specific models or allow access to all models.
|
||||
|
||||
## Configuration
|
||||
|
||||
### CLI setup
|
||||
|
||||
```bash
|
||||
clawdbot onboard --auth-choice pollinations
|
||||
# or non-interactive
|
||||
clawdbot config set env.POLLINATIONS_API_KEY "sk-..."
|
||||
```
|
||||
|
||||
### Config snippet
|
||||
|
||||
```json5
|
||||
{
|
||||
env: { POLLINATIONS_API_KEY: "sk-..." },
|
||||
models: {
|
||||
providers: {
|
||||
pollinations: {
|
||||
baseUrl: "https://gen.pollinations.ai/v1",
|
||||
apiKey: "${POLLINATIONS_API_KEY}",
|
||||
api: "openai-completions",
|
||||
models: [
|
||||
{
|
||||
id: "openai",
|
||||
name: "GPT-5 via Pollinations",
|
||||
reasoning: false,
|
||||
input: ["text", "image"],
|
||||
cost: { input: 0.002, output: 0.006, cacheRead: 0.001, cacheWrite: 0.0025 },
|
||||
contextWindow: 128000,
|
||||
maxTokens: 16384
|
||||
},
|
||||
{
|
||||
id: "claude",
|
||||
name: "Claude via Pollinations",
|
||||
reasoning: false,
|
||||
input: ["text", "image"],
|
||||
cost: { input: 0.003, output: 0.015, cacheRead: 0.0003, cacheWrite: 0.00375 },
|
||||
contextWindow: 200000,
|
||||
maxTokens: 8192
|
||||
},
|
||||
{
|
||||
id: "gemini",
|
||||
name: "Gemini via Pollinations",
|
||||
reasoning: false,
|
||||
input: ["text", "image"],
|
||||
cost: { input: 0.001, output: 0.002, cacheRead: 0.0001, cacheWrite: 0.0005 },
|
||||
contextWindow: 128000,
|
||||
maxTokens: 8192
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
},
|
||||
agents: {
|
||||
defaults: {
|
||||
model: { primary: "pollinations/openai" }
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Available models
|
||||
|
||||
Pollinations provides access to many models through its unified API:
|
||||
|
||||
### Text Generation
|
||||
- `openai` — GPT-5
|
||||
- `claude` — Claude (latest)
|
||||
- `gemini` — Gemini Pro
|
||||
- `gemini-large` — Gemini with code execution
|
||||
- `gemini-search` — Gemini with Google Search
|
||||
- `grok` — Grok
|
||||
- `nomnom` (alias `gemini-scrape`) — Web research and scraping
|
||||
|
||||
### Image Generation
|
||||
- `flux` — FLUX models for text-to-image
|
||||
- `gptimage-large` — GPT Image
|
||||
- `seedream` — Seedream image generation
|
||||
- `klein` — FLUX.2 klein for fast text-to-image
|
||||
|
||||
### Video Generation (alpha)
|
||||
- `seedance` — Text-to-video
|
||||
- `veo` — Text-to-video
|
||||
|
||||
## Authentication
|
||||
|
||||
Pollinations supports two authentication methods:
|
||||
|
||||
1. **API Key in URL** (for simple requests):
|
||||
```bash
|
||||
curl 'https://gen.pollinations.ai/text/hello?key=YOUR_API_KEY'
|
||||
```
|
||||
|
||||
2. **Bearer Token in Header** (recommended for Clawdbot):
|
||||
```bash
|
||||
curl 'https://gen.pollinations.ai/v1/chat/completions' \
|
||||
-H 'Authorization: Bearer YOUR_API_KEY' \
|
||||
-H 'Content-Type: application/json' \
|
||||
-d '{"model": "openai", "messages": [{"role": "user", "content": "Hello"}]}'
|
||||
```
|
||||
|
||||
Clawdbot uses the Bearer Token method automatically when you set `POLLINATIONS_API_KEY`.
|
||||
|
||||
## Security
|
||||
|
||||
- **Never share your API key publicly** — Don't commit keys to Git repositories
|
||||
- **Use environment variables** — Store your key in `.env` files
|
||||
- **Use secret keys for production** — Secret keys (sk_) have no rate limits and should only be used server-side
|
||||
- **Scope your keys** — When creating keys, restrict them to only the models you need
|
||||
|
||||
## Pricing
|
||||
|
||||
Pollinations uses a **Pollen credits system**:
|
||||
- $1 ≈ 1 Pollen
|
||||
- Pay-as-you-go billing
|
||||
- Different tier levels (Seed, Flower, Nectar) provide different usage quotas
|
||||
- Seed tier is automatic on first login
|
||||
|
||||
Check your balance and usage:
|
||||
```bash
|
||||
# Balance
|
||||
curl 'https://gen.pollinations.ai/account/balance' \
|
||||
-H 'Authorization: Bearer YOUR_API_KEY'
|
||||
|
||||
# Usage history
|
||||
curl 'https://gen.pollinations.ai/account/usage' \
|
||||
-H 'Authorization: Bearer YOUR_API_KEY'
|
||||
```
|
||||
|
||||
## Notes
|
||||
|
||||
- **OpenAI-compatible** — Pollinations uses the OpenAI Completions API format, so it works seamlessly with Clawdbot's OpenAI provider adapter
|
||||
- **Multi-modal support** — Many models support both text and image inputs
|
||||
- **Tool support** — Gemini models include code_execution and google_search tools
|
||||
- **Response formats** — Some responses may include special content blocks (image_url, thinking) depending on the model
|
||||
- **Beta status** — Pollinations is in active development; features and pricing may change
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Authentication errors
|
||||
|
||||
If you see `401 Unauthorized`:
|
||||
- Verify your API key is correct
|
||||
- Make sure you're using the right key type (secret keys for server-side)
|
||||
- Check that your key hasn't expired
|
||||
|
||||
### Model not found
|
||||
|
||||
If a model isn't available:
|
||||
- Check the [API documentation](https://enter.pollinations.ai/api/docs) for current model names
|
||||
- Some models may be in limited access or beta
|
||||
- Try using a different model from the list above
|
||||
|
||||
### Rate limits (publishable keys only)
|
||||
|
||||
Publishable keys (pk_) have rate limits. If you hit limits:
|
||||
- Use a secret key (sk_) for server-side usage
|
||||
- Upgrade your tier for higher quotas
|
||||
- Check your usage at [enter.pollinations.ai](https://enter.pollinations.ai)
|
||||
|
||||
## See Also
|
||||
|
||||
- [Pollinations.ai Website](https://pollinations.ai)
|
||||
- [API Documentation](https://enter.pollinations.ai/api/docs)
|
||||
- [Model Providers](/concepts/model-providers) - Overview of all providers
|
||||
- [Model Selection](/concepts/models) - How to choose models
|
||||
- [Configuration](/gateway/configuration) - Full config reference
|
||||
Loading…
Reference in New Issue
Block a user