AI Image Generation Skill

A Claude Code skill for generating high-quality AI images using OpenAI's gpt-image-1 model with customizable aspect ratios and artistic themes.

Features

Generate images from text prompts using OpenAI's latest gpt-image-1 model
Choose from multiple aspect ratios (vertical, horizontal, square)
Apply different artistic themes (Studio Ghibli, futuristic, Pixar, oil painting, Chinese painting)
Customizable output location
High-quality image generation up to 4096x4096 pixels
Base64 image handling for reliable downloads

Installation

This is a Claude Code skill. To use it:

Ensure you have uv installed
Clone or place this skill in your project
Set your OpenAI API key:

export OPENAI_API_KEY='your-api-key-here'

Note: Using gpt-image-1 requires organization verification on platform.openai.com.

Usage

Basic Usage

uv run main.py --prompt "a cat sitting on a tree"

With Style and Theme

uv run main.py --prompt "a sunset over mountains" --style horizontal --theme oil-paint --output ./sunset.png

More Examples

# Futuristic portrait
uv run main.py --prompt "a robot in a city" --style vertical --theme futuristic --output ./robot.png

# Studio Ghibli landscape
uv run main.py --prompt "a magical forest with spirits" --style horizontal --theme ghibli --output ./forest.png

# Pixar-style character
uv run main.py --prompt "a friendly dragon" --style square --theme pixar --output ./dragon.png

Options

--prompt: Text description of the image to generate (required)
--style: Image aspect ratio (default: square)
- vertical: 1024x1536 pixels (portrait)
- horizontal: 1536x1024 pixels (landscape)
- square: 1024x1024 pixels
--theme: Artistic theme (optional)
- ghibli: Studio Ghibli animation style
- futuristic: Sci-fi with sleek designs and neon lights
- pixar: Vibrant 3D animation style
- oil-paint: Classical oil painting with textures
- chinese-paint: Traditional Chinese ink painting
--output: Output file path (default: ./generated_image.png)

Technical Details

Model: OpenAI gpt-image-1 (released April 2025)
Supported Sizes: 1024x1024, 1024x1536, 1536x1024
Maximum Resolution: Up to 4096x4096 pixels
Response Format: Base64 encoded images (b64_json)
Dependencies: openai>=2.7.1

Pricing

Usage is priced per token:

Text tokens: $5 per million
Image input tokens: $10 per million
Image output tokens: $40 per million

Approximate costs per generated image:

Low quality square: ~$0.02
Medium quality square: ~$0.07
High quality square: ~$0.19

Troubleshooting

API Key Not Set

If you see "Error: OPENAI_API_KEY environment variable not set":

export OPENAI_API_KEY='your-api-key-here'

Organization Not Verified

gpt-image-1 requires organization verification. Visit platform.openai.com and complete the verification process in your account settings.

Invalid Size Error

Ensure you're using one of the supported aspect ratios: vertical, horizontal, or square.

License

This skill is provided as-is for use with Claude Code.

3.2 KiB Raw Blame History