image-generation

name	image-generation
description	Generate and edit images using Gemini Flash Image, and generate videos using Veo. Supports text-to-image, image editing, text-to-video, and image-to-video.

Media Generation

Generate images and videos using Gemini APIs.

Image Generation (Gemini Flash Image)

• Text-to-image: Generate images from text descriptions
• Image editing: Modify existing images with natural language
• Background replacement: Change or enhance backgrounds
• Hero/banner creation: Create branded images with text overlays
• Style transfer: Apply artistic styles to photos

Video Generation (Veo)

• Text-to-video: Generate video clips from text prompts
• Image-to-video: Animate a reference image with a prompt

When to Use

• "Generate a hero image for my project"
• "Create a short video of a sunset timelapse"
• "Edit this photo to remove the background"
• "Make a video from this image"
• "Generate a logo with a dark theme"

Usage

# Text-to-image
python3 "$SKILL_DIR/scripts/generate.py" --prompt "A futuristic city skyline at night"

# Edit an existing image
python3 "$SKILL_DIR/scripts/generate.py" --input photo.jpg --prompt "Add dramatic clouds"

# Specify output path
python3 "$SKILL_DIR/scripts/generate.py" --prompt "A cute robot mascot" --output mascot.png

# Text-to-video
python3 "$SKILL_DIR/scripts/generate.py" --video --prompt "A timelapse of a city at sunset"

# Video with portrait aspect ratio
python3 "$SKILL_DIR/scripts/generate.py" --video --prompt "Ocean waves" --aspect 9:16

# Image-to-video (animate a reference image)
python3 "$SKILL_DIR/scripts/generate.py" --video --input scene.jpg --prompt "Animate this scene with gentle wind"

# Specify output
python3 "$SKILL_DIR/scripts/generate.py" --video --prompt "Dancing robot" --output robot.mp4

Options

Flag	Description	Default
--prompt	Text prompt describing what to generate	(required)
--input	Input image path(s) for editing/reference	None
--output	Output file path	generated-{timestamp}.png or .mp4
--model	Gemini model to use	gemini-2.5-flash-image / veo-3.1-generate-preview
--video	Generate video instead of image	false
--aspect	Video aspect ratio	16:9
--quality	JPEG quality (1-100, images only)	90

Requirements

• google-genai Python package (pip3 install google-genai)
• GEMINI_API_KEY in .env or environment
• Pillow (pip3 install Pillow) — for image generation/editing

Notes

• Video generation takes 1-3 minutes (polling every 10s)
• Generated videos are stored on Google servers for 2 days
• Gemini may refuse some prompts (people's faces, copyrighted characters, etc.)
• For image editing, be explicit: "keep the subject unchanged, only modify the background"
• Image output format inferred from extension (.jpg, .png, .webp)
• Maximum input image size: ~20MB