Cloudflare Image Generation (Free)

AI image generation via Cloudflare Workers AI (free tier, FLUX models) with optional prompt enhancement via Ollama or the primary LLM agent. Use when generating images from text prompts, creating visual assets, or when the user asks to generate/create an image. Triggers: 'generate image', 'create image', 'draw me', 'make an image', 'imagine', image generation requests. Zero cost on free tier (10K neurons/day).

NoodlyPandaStories@paradoxfuzzle

Install

openclaw skills install @paradoxfuzzle/cf-img-gen

CF Image Gen — Cloudflare Workers AI Image Generation

Free AI image generation using Cloudflare Workers AI, with optional prompt enhancement to refine and expand short prompts into detailed, vivid descriptions before generation.

Two enhancement paths:

Primary LLM agent — the calling AI agent (e.g. Jerith, running on OpenRouter/GPT/etc.) enhances the prompt before passing it to the skill. Higher quality, more creative, understands context.
Ollama — a local or remote Ollama LLM handles enhancement. Good for automation, no external API calls, works standalone.

Prerequisites
Installation
Configuration
Usage
Prompt Enhancement
Models
API Reference
Troubleshooting
File Layout

Prerequisites

Before using this skill, you need:

A Cloudflare account — Sign up at https://cloudflare.com (free tier is sufficient)
Workers AI enabled — Go to https://dash.cloudflare.com → Workers & Pages → Overview
Node.js 18+ — Required to run the script
Ollama (optional) — For standalone prompt enhancement. Can be local or remote. Install at https://ollama.com

Installation

Step 1: Copy the skill to your workspace

Copy the cf-img-gen directory to your OpenClaw workspace skills folder:

bash

cp -r cf-img-gen ~/.openclaw/workspace/skills/cf-img-gen

Step 2: Create the credentials file

Copy the example env file and fill in your credentials:

bash

# Create the credentials file
mkdir -p ~/.openclaw/workspace/ACCESS
cat > ~/.openclaw/workspace/ACCESS/cloudflare-workers-ai.env << 'EOF'
CF_WORKERS_AI_TOKEN=your_api_token_here
CF_WORKERS_AI_ACCOUNT=your_account_id_here
EOF

# Edit with your actual credentials
nano ~/.openclaw/workspace/ACCESS/cloudflare-workers-ai.env

Step 3: Secure the credentials file

bash

chmod 600 ~/.openclaw/workspace/ACCESS/cloudflare-workers-ai.env

Step 4: Verify it works

bash

cd ~/.openclaw/workspace/skills/cf-img-gen
node cf-img-gen.js "a test image of a blue circle" --width 512 --height 512

You should see output like:

text

🎨 Generating with flux-schnell (512x512)...
✅ Saved: /home/user/.openclaw/media/cf-img-gen/cf-img-1234567890.jpg

MEDIA:/home/user/.openclaw/media/cf-img-gen/cf-img-1234567890.jpg

Configuration

Cloudflare Credentials File

The skill reads Cloudflare credentials from ~/.openclaw/workspace/ACCESS/cloudflare-workers-ai.env.

Create this file with the following format:

text

CF_WORKERS_AI_TOKEN=your_api_token_here
CF_WORKERS_AI_ACCOUNT=your_account_id_here

Getting Your Cloudflare API Token

Log in to the Cloudflare dashboard: https://dash.cloudflare.com
Click your profile icon (top right) → My Profile
Go to API Tokens → Create Token
Use the "Workers AI" template or create a custom token with:
- Account → Workers AI → Edit (minimum: Read)
Copy the token and paste it into the env file

Getting Your Cloudflare Account ID

Log in to the Cloudflare dashboard: https://dash.cloudflare.com
Go to Workers & Pages → Overview
Your Account ID is displayed on the right side (alphanumeric string, ~32 characters)
Copy it and paste it into the env file

Ollama Configuration (Optional)

Ollama prompt enhancement can use either a local or remote Ollama instance.

Defaults (no configuration needed for local Ollama):

Host: http://localhost:11434
Model: llama3.2:3b
Timeout: 30000 ms

Customizing Ollama connection:

Via environment variables:

bash

export OLLAMA_HOST=http://192.168.1.100:11434
export OLLAMA_MODEL=qwen2.5:7b

Via CLI flags:

bash

node cf-img-gen.js "red panda" --ollama --ollama-host http://192.168.1.100:11434 --ollama-model qwen2.5:7b

Via API options (see API Reference).

Setting up a remote Ollama server:

If running Ollama on a different machine, ensure it's accessible:

bash

# On the Ollama server, bind to all interfaces
OLLAMA_HOST=0.0.0.0 ollama serve

Then connect from your client:

bash

node cf-img-gen.js "red panda" --ollama --ollama-host http://your-server-ip:11434

Output Directory

Generated images are saved to: ~/.openclaw/media/cf-img-gen/

The directory is created automatically on first run.

Usage

As a Module (Programmatic)

javascript

const imgGen = require('./cf-img-gen');

// ── Basic usage (no enhancement) ──
const result = await imgGen.generate({ prompt: "a red panda in space" });

// ── With image options ──
const result = await imgGen.generate({
  prompt: "a cyberpunk city at night",
  width: 1024,
  height: 768,
  model: "flux-dev",
  steps: 8,
});

// ── With Ollama prompt enhancement (default local) ──
const result = await imgGen.generate({
  prompt: "red panda",
  ollama: true,
});

// ── With Ollama using custom model and remote host ──
const result = await imgGen.generate({
  prompt: "red panda",
  ollama: {
    host: "http://192.168.1.100:11434",
    model: "qwen2.5:7b",
    timeout: 30000,
  },
});

// ── With primary LLM agent enhancement ──
// (The calling LLM enhances the prompt before calling generate)
const enhancedPrompt = "A fluffy red panda sitting on a mossy branch in a misty forest, soft morning light filtering through the canopy, detailed fur texture, cinematic composition, 8K quality";
const result = await imgGen.generate({
  prompt: "red panda",
  llm: { enhancedPrompt },
});

// ── Check enhancement results ──
if (result.prompt.enhanced) {
  console.log("Original:", result.prompt.original);
  console.log("Enhanced:", result.prompt.enhanced);
  console.log("Source:", result.enhancement.source); // 'llm' or 'ollama'
}

CLI

bash

# Basic generation (default: 1024x1024, flux-schnell)
node cf-img-gen.js "a sunset over the ocean"

# Specify dimensions
node cf-img-gen.js "a mountain landscape" --width 1024 --height 768

# Use a different model
node cf-img-gen.js "a detailed portrait" --model flux-dev

# More inference steps for higher quality
node cf-img-gen.js "a complex scene" --model flux-dev --steps 8

# Enable Ollama prompt enhancement (default local model)
node cf-img-gen.js "red panda" --ollama

# Ollama with custom model
node cf-img-gen.js "red panda" --ollama --ollama-model qwen2.5:7b

# Ollama with remote host
node cf-img-gen.js "red panda" --ollama --ollama-host http://192.168.1.100:11434

# Provide a pre-enhanced prompt (from LLM agent)
node cf-img-gen.js "red panda" --enhanced-prompt "A fluffy red panda sitting on a mossy branch in a misty forest, soft morning light, detailed fur, cinematic"

# Combined: Ollama + custom model + image options
node cf-img-gen.js "red panda" --ollama --ollama-model llama3.2:3b --width 1024 --height 1024 --model flux-dev

# Show help
node cf-img-gen.js --help

In OpenClaw / Discord (LLM Agent Usage)

When an LLM agent (like Jerith) handles image generation requests:

Evaluate the user's prompt — if it's short or vague, enhance it yourself
Enhance the prompt — expand it with visual details: lighting, composition, style, mood, colors, textures, atmosphere
Call generate() with the original prompt + your enhanced version via llm.enhancedPrompt
Return MEDIA:<filepath> for Discord auto-attach

Example agent workflow:

text

User: "draw me a red panda"

Agent thinks: "Short prompt — I should enhance it."
Enhanced: "A fluffy red panda sitting on a mossy branch in a misty bamboo forest, soft golden morning light filtering through the canopy, detailed fur texture with warm russet and cream tones, shallow depth of field, cinematic composition, peaceful atmosphere, 8K quality"

Agent calls:
  generate({
    prompt: "draw me a red panda",
    llm: { enhancedPrompt: "A fluffy red panda sitting on..." }
  })

Agent responds:
  🎨 Generated with flux-schnell (1024x1024) [llm enhanced]
  MEDIA:/path/to/image.jpg

When to enhance:

Short prompts (1-4 words) — almost always enhance
Vague prompts ("something cool", "make it pretty") — enhance with specifics
Detailed prompts — pass through as-is, no enhancement needed
User explicitly says "don't change my prompt" — skip enhancement

Prompt Enhancement

Enhancement Priority

When multiple enhancement options are provided, the skill uses this priority:

llm.enhancedPrompt — pre-enhanced by the primary LLM agent (highest priority)
ollama — Ollama LLM enhancement
Original prompt — no enhancement (fallback)

If llm.enhancedPrompt is provided, Ollama is skipped entirely. If skipEnhance is true, all enhancement is bypassed.

Path 1: Primary LLM Agent Enhancement

The calling LLM agent (e.g. Jerith) enhances the prompt before calling generate().

Advantages:

Higher quality — the primary LLM is typically more capable than a small local model
Context-aware — understands the conversation, user preferences, and intent
Creative — can add artistic direction, references, and nuance
No extra infrastructure — uses the agent that's already running
No additional latency from a separate API call

How to use:

javascript

// The agent enhances the prompt itself, then passes it
const result = await imgGen.generate({
  prompt: "red panda",
  llm: {
    enhancedPrompt: "A fluffy red panda in a misty forest, golden light, cinematic"
  },
});

CLI equivalent:

bash

node cf-img-gen.js "red panda" --enhanced-prompt "A fluffy red panda in a misty forest, golden light, cinematic"

Path 2: Ollama Enhancement

A local or remote Ollama LLM handles enhancement automatically.

Advantages:

Works standalone — no need for the calling agent to enhance
Consistent — same enhancement behavior every time
Private — stays on your hardware (local Ollama)
Good for automation — scripts and pipelines can use it without LLM agent involvement

How to use:

javascript

const result = await imgGen.generate({
  prompt: "red panda",
  ollama: true,  // uses defaults
});

// Or with custom options
const result = await imgGen.generate({
  prompt: "red panda",
  ollama: {
    host: "http://192.168.1.100:11434",
    model: "qwen2.5:7b",
    timeout: 30000,
  },
});

Graceful Degradation

If Ollama is unreachable (not running, network error, timeout), the skill falls back to the original prompt without throwing an error. A warning is logged to stderr. LLM agent enhancement has no failure mode — the agent either provides an enhanced prompt or doesn't.

Recommended Ollama Models

Model	Size	Speed	Quality	Best For
`llama3.2:3b` (default)	3B	Fast	Good	General use, quick enhancement
`qwen2.5:7b`	7B	Medium	Great	Better detail, creative prompts
`llama3.1:8b`	8B	Medium	Great	Balanced quality/speed
`mistral:7b`	7B	Medium	Good	Alternative to llama

Models

Model	API Key	Speed	Quality	Best For
FLUX.1 Schnell	`flux-schnell`	~1-3s	Good	Quick generations, general use (default)
FLUX.1 Dev	`flux-dev`	~5-10s	Great	Higher quality, more detail
Stable Diffusion XL	`sdxl`	~3-5s	Good	SDXL-style outputs
DreamShaper 8 LCM	`dreamshaper`	~2-4s	Good	Artistic/stylized images

Recommendation: Use flux-schnell for quick iterations and general use. Switch to flux-dev with higher steps (6-8) for final/high-quality outputs.

API Reference

`generate(options)`

Generate an image from a text prompt, with optional prompt enhancement.

Parameters:

Parameter	Type	Default	Description
`prompt`	string	required	Text description of the image to generate
`width`	number	1024	Image width in pixels
`height`	number	1024	Image height in pixels
`model`	string	`flux-schnell`	Model to use (see Models table)
`steps`	number	4	Number of inference steps (higher = more detail, slower)
`ollama`	`object\|true\|null`	`null`	Enable Ollama prompt enhancement. Pass `true` for defaults, or an object with `{ host, model, timeout }`
`llm`	`object\|null`	`null`	Pre-enhanced prompt from the primary LLM agent. Object with `{ enhancedPrompt: "..." }`
`skipEnhance`	boolean	`false`	If true, skip all prompt enhancement

Enhancement priority: llm.enhancedPrompt > ollama > original prompt

Ollama options (when ollama is an object):

Field	Type	Default	Description
`host`	string	`http://localhost:11434`	Ollama server URL (local or remote)
`model`	string	`llama3.2:3b`	Ollama model to use for enhancement
`timeout`	number	`30000`	Request timeout in milliseconds

Returns: Promise<object>

javascript

{
  filepath: "/home/user/.openclaw/media/cf-img-gen/cf-img-1234567890.jpg",
  source: "cloudflare-workers-ai",
  model: "flux-schnell",
  width: 1024,
  height: 1024,
  cost: 0,
  size: 184320,           // bytes
  prompt: {
    original: "red panda",
    enhanced: "A fluffy red panda sitting on a mossy branch...",  // null if not enhanced
    used: "A fluffy red panda sitting on a mossy branch..."
  },
  enhancement: {
    source: "llm",           // 'llm' or 'ollama' (null if not enhanced)
    ollama: null,            // { host, model } if Ollama was used, else null
    llm: {
      note: "Enhanced by primary LLM agent before calling generate()"
    }  // null if LLM was not used
  }
}

Throws: Error if prompt is missing, credentials are invalid, or Cloudflare API request fails. Ollama failures are non-fatal (falls back to original prompt).

`enhancePromptOllama(prompt, options)`

Standalone function to enhance a prompt via Ollama without generating an image.

Parameters:

Parameter	Type	Default	Description
`prompt`	string	required	Original prompt to enhance
`options.host`	string	`http://localhost:11434`	Ollama server URL
`options.model`	string	`llama3.2:3b`	Ollama model to use
`options.timeout`	number	`30000`	Request timeout in ms

Returns: Promise<string> — The enhanced prompt (or original on failure).

`MODELS`

Object mapping model names to Cloudflare API identifiers:

javascript

{
  'flux-schnell': '@cf/black-forest-labs/flux-1-schnell',
  'flux-dev': '@cf/black-forest-labs/flux-1-dev',
  'sdxl': '@cf/stabilityai/stable-diffusion-xl-base-1.0',
  'dreamshaper': '@cf/lykon/dreamshaper-8-lcm',
}

Troubleshooting

"Missing ACCESS/cloudflare-workers-ai.env"

The credentials file doesn't exist at ~/.openclaw/workspace/ACCESS/cloudflare-workers-ai.env. Create it from the example file:

bash

cp skills/cf-img-gen/cloudflare-workers-ai.env.example \
   ~/.openclaw/workspace/ACCESS/cloudflare-workers-ai.env
# Then edit with your credentials

"CF_WORKERS_AI_TOKEN not found in env file"

The env file exists but doesn't contain the expected variables. Ensure the file has:

text

CF_WORKERS_AI_TOKEN=your_token
CF_WORKERS_AI_ACCOUNT=your_account_id

No quotes, no extra spaces around =.

"Cloudflare API error: Authentication error"

Your API token is invalid or doesn't have Workers AI permissions. Check:

The token is copied correctly (no extra whitespace)
The token has Workers AI permissions (Account → Workers AI → Edit or Read)
Your Account ID matches the account the token was created on

"Cloudflare API error: HTTP 429"

You've hit the rate limit. The free tier allows ~10K neurons/day. Wait a moment and try again.

"No image in response"

The API returned a 200 but without image data. This can happen with:

Invalid model names
Prompts that trigger content filters
Temporary Cloudflare API issues

Try again with a different prompt or model.

Ollama: "Ollama unavailable"

Ollama prompt enhancement failed. The skill will fall back to the original prompt. To fix:

Ensure Ollama is running: ollama serve
Pull the model: ollama pull llama3.2:3b
For remote Ollama, verify the host URL is reachable
Check firewall rules if using a remote Ollama instance

Ollama: "Ollama returned empty response"

The Ollama model returned an empty or malformed response. Try:

A different model (e.g., qwen2.5:7b instead of llama3.2:3b)
Increasing the timeout for slower models/servers
Checking Ollama logs for model errors

Request timeout

Large images or high step counts can take longer. The Cloudflare timeout is set to 120 seconds. The Ollama timeout defaults to 30 seconds (configurable via --ollama-timeout or ollama.timeout).

File Layout

text

cf-img-gen/
├── cf-img-gen.js                     # Main module (CLI + programmatic API)
├── SKILL.md                          # This file — installation and usage guide
├── cloudflare-workers-ai.env.example # Template for credentials
└── CHANGELOG.md                      # Version history

Output images are stored separately:

text

~/.openclaw/media/cf-img-gen/
├── cf-img-1700000000000.jpg
├── cf-img-1700000001000.jpg
└── ...

Cloudflare Image Generation (Free)

Install

CF Image Gen — Cloudflare Workers AI Image Generation

Table of Contents

Prerequisites

Installation

Step 1: Copy the skill to your workspace

Step 2: Create the credentials file

Step 3: Secure the credentials file

Step 4: Verify it works

Configuration

Cloudflare Credentials File

Getting Your Cloudflare API Token

Getting Your Cloudflare Account ID

Ollama Configuration (Optional)

Output Directory

Usage

As a Module (Programmatic)

CLI

In OpenClaw / Discord (LLM Agent Usage)

Prompt Enhancement

Enhancement Priority

Path 1: Primary LLM Agent Enhancement

Path 2: Ollama Enhancement

Graceful Degradation

Recommended Ollama Models

Models

API Reference

generate(options)

enhancePromptOllama(prompt, options)

MODELS

Troubleshooting

"Missing ACCESS/cloudflare-workers-ai.env"

"CF_WORKERS_AI_TOKEN not found in env file"

"Cloudflare API error: Authentication error"

"Cloudflare API error: HTTP 429"

"No image in response"

Ollama: "Ollama unavailable"

Ollama: "Ollama returned empty response"

Request timeout

File Layout

Related skills

`generate(options)`

`enhancePromptOllama(prompt, options)`

`MODELS`