Free AI text-to-image generation. Turn text descriptions into images. No API key required. Supports multiple models via Pollinations.ai free API.
---
name: text-to-image-free
description: >
Free AI text-to-image generation.
Turn text descriptions into images. No API key required.
Supports multiple models via Pollinations.ai free API.
version: 1.3.0
metadata:
openclaw:
requires:
bins:
- curl
- python3
emoji: "🎨"
homepage: https://clawhub.ai/BusTes01/text-to-image-free
models:
- sana
- flux
- turbo
- dreamshaper
---
# 🎨 Text-to-Image Free
A free AI image generation tool. User provides a text description, and the agent generates a corresponding image. **No API key required**, zero cost. Powered by Pollinations.ai free API.
## Usage
User says: "generate an image: a Shiba Inu on a beach drinking coconut water"
The agent performs the following workflow:
### Step 1: Extract Prompt
Extract the image description from user input.
Trigger keywords: "generate", "create an image", "draw", "make a picture"
### Step 2: Set Parameters
| Parameter | Default | Description |
|-----------|---------|-------------|
| width | 1024 | Image width in px |
| height | 768 | Image height in px |
| model | `sana` | `sana` / `flux` / `turbo` / `dreamshaper` |
| nologo | true | Remove watermark |
| seed | random | Fixed integer for reproducible results |
User can override:
```
"Generate: cyberpunk Shanghai night view, width 1920 height 1080, use flux model"
"Generate another, use seed=42 for consistent style"
```
### Step 3: Call API
Use `exec` to run curl against Pollinations.ai:
```bash
PROMPT="<your text description>"
WIDTH=1024
HEIGHT=768
SEED="" # optional: "42"
curl -s --max-time 180 \
"https://image.pollinations.ai/prompt/$(python3 -c "import urllib.parse; print(urllib.parse.quote('$PROMPT'))")?width=$WIDTH&height=$HEIGHT&nologo=true${SEED:+&seed=$SEED}" \
-o /tmp/generated_image.jpg
```
### Step 4: Return Result
Return the generated image file to the user.
## Model Selection
| Model | Features | Speed |
|-------|----------|-------|
| `sana` (default) | Latest efficient model, balanced style & detail | Fast |
| `flux` | Higher quality, richer detail | Moderate |
| `turbo` | Fastest generation, good for previews | Fastest |
| `dreamshaper` | Artistic / dream-like style | Medium |
> As of May 2026, Pollinations.ai default model has been switched to **Sana**. Older models like `stable-diffusion` are deprecated. Sana offers better speed-quality balance.
## Examples
```
User: "Generate: cyberpunk Shanghai night, neon lights, flying cars"
→ Agent calls API → returns image ✓
User: "Generate: an orange cat wearing an astronaut helmet, cartoon style, use flux model"
→ Agent calls API → returns image ✓
```
## Notes
- Free API has queue limits: one request at a time
- Generation takes ~15-60 seconds (Sana is faster than predecessors)
- English prompts yield best results
- Use `seed` parameter (e.g., `&seed=42`) for reproducible results
- Non-commercial use only (Pollinations.ai free tier limitation)
---
# 🎨 文生图(免费)
一个免费的AI图片生成工具。用户输入描述性文字,即可生成对应的图片。**无需任何API Key**,零成本使用。基于 Pollinations.ai 免费API。
## 使用方法
用户说:"画一张图:一只柴犬在沙滩上喝椰子水"
Agent 执行以下流程:
### 第一步:提取提示词
从用户输入中提取图片描述文本。
关键词触发:"画一张图"/"生成图片"/"画"/"create"/"generate"
### 第二步:调整参数
| 参数 | 默认值 | 说明 |
|------|--------|------|
| width | 1024 | 图片宽度 |
| height | 768 | 图片高度 |
| model | `sana` | `sana` / `flux` / `turbo` / `dreamshaper` |
| 无水印 | 是 | 默认去除水印 |
| seed | 随机 | 固定值可复现相同结果 |
用户可指定参数:
```
"画一张图:赛博朋克上海夜景,宽1920高1080,使用flux模型"
"再生成一次,用seed=42保持风格一致"
```
### 第三步:调用API
使用 `exec` 运行 curl 命令调用 Pollinations.ai:
```bash
PROMPT="<图片描述文字>"
WIDTH=1024
HEIGHT=768
SEED="" # 可选:"42"
curl -s --max-time 180 \
"https://image.pollinations.ai/prompt/$(python3 -c "import urllib.parse; print(urllib.parse.quote('$PROMPT'))")?width=$WIDTH&height=$HEIGHT&nologo=true${SEED:+&seed=$SEED}" \
-o /tmp/generated_image.jpg
```
### 第四步:返回结果
将生成的图片文件返回给用户。
## 模型选择
| 模型 | 特点 | 速度 |
|------|------|------|
| `sana`(默认) | 最新高效模型,通用风格,细节出色 | 快 |
| `flux` | 更高质量,细节丰富 | 稍慢 |
| `turbo` | 极速生成,适合快速预览 | 最快 |
| `dreamshaper` | 偏向艺术/梦幻风格 | 中等 |
> 2026年5月更新:Pollinations.ai 已将默认模型切换为 **Sana**,前代模型(如stable-diffusion)已下线。Sana在速度和画质间取得更好平衡。
## 示例
```
用户:「画一张图:赛博朋克上海夜景,霓虹灯,飞行汽车」
→ Agent 调用API → 返回图片 ✓
用户:「画一张图:一只橘猫戴着宇航员头盔,卡通风格,使用flux模型」
→ Agent 调用API → 返回图片 ✓
```
## 注意事项
- 免费API有队列限制,一次只能处理一个请求
- 生成时间约15-60秒(Sana模型较前代更快)
- 建议使用英文提示词获得最佳效果,中文也支持
- 支持 `seed` 参数(如 `&seed=42`)获得可复现结果
- 仅限非商业用途(Pollinations.ai免费层限制)
don't have the plugin yet? install it then click "run inline in claude" again.