generate-image - AI Image Generation

SkillMedia

Lets your agent generate or edit images like photos, illustrations, and artwork using AI models.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the generate-image - AI Image Generation skill

About this capability

AI image generation CLI using Gemini. Use when generating images, checking syntax for resolution, aspect ratio, and reference image options.

What this skill tells your AI

The instructions your AI receives, as published by ansari-project/ansari-frontend in .claude/skills/generate-image/SKILL.md and read by ahel’s review.

Uses Google Gemini (gemini-3-pro-image-preview) to generate images from text prompts.

Synopsis

codev generate-image "<prompt>" [options]

Options

-o, --output <file>        # Output file path (default: output.png)
-r, --resolution <res>     # Resolution: 1K, 2K, 4K (default: 1K)
-a, --aspect <ratio>       # Aspect ratio (default: 1:1)
--ref <image>              # Reference image (repeatable, max 14)

Aspect Ratios

1:1 | 16:9 | 9:16 | 3:4 | 4:3 | 3:2 | 2:3

Examples

# Basic generation
codev generate-image "A sunset over mountains"

# High-res widescreen
codev generate-image "A futuristic city" -r 4K -a 16:9 -o city.png

# With reference images (style transfer)
codev generate-image "Same style but with cats" --ref style.png --ref layout.png

# Prompt from file
codev generate-image prompt.txt -o result.png

Prerequisites

Requires GEMINI_API_KEY or GOOGLE_API_KEY environment variable. Get a key at https://aistudio.google.com/apikey

Common Mistakes

  • Prompt must be quoted if it contains spaces
  • Prompt can also be a .txt file path (auto-detected by extension)
  • Reference images must exist on disk — max 14 images
  • Output defaults to output.png in current directory — use -o to change

Signals

GitHub stars
27
Forks
16
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
generate-image
Source
github.com/ansari-project/ansari-frontend