Image Generation & Editing (GPT Image default, Gemini fallback)

Generate new images or edit existing ones. The script picks a provider based on which API keys are available:

1. OpenAI gpt-image-2 — used when OPENAI_API_KEY is set (default).
2. Gemini gemini-3.1-flash-image-preview — used when only GEMINI_API_KEY is set.

When both keys are set, OpenAI is picked by default; force Gemini with --provider gemini. If an auto-selected OpenAI call fails at runtime (quota, moderation, network), the script transparently falls back to Gemini when a Gemini key is available.

Usage

The script is at scripts/generate_image.py relative to this skill's directory (the directory containing this SKILL.md). Resolve the full path from the skill's location before running. Do not hardcode ~/.codex/..., because the skill may be installed in a different location.

Keep the distinction clear:

• The script path tells you where to find generate_image.py.
• The output path is controlled by the current working directory plus --filename.
• Run from the user's working directory so relative filenames save output there, not in the skill directory.