| name | chatgpt-imagegen |
| description | Generate or edit raster images with OpenAI's Image API from text prompts, reference images, and optional masks. Use for illustrations, portraits, concept art, product mockups, transparent assets, or controlled visual edits. |
| license | MIT |
| compatibility | Requires Python 3.10+, openai 2.16+, network access, and an OpenAI API key. |
ChatGPT Image Generation
Use the bundled chatgpt-img CLI for generation and edits. Resolve its path relative to this SKILL.md.
Setup
python3 -m pip install -r <skill-directory>/requirements.txt
export OPENAI_API_KEY='...'
OPENCODE_OPENAI_API_KEY is accepted as a fallback. CHATGPT_IMAGE_DEFAULT overrides the default model.
Image requests cost money. Confirm scope before generating many images or using high quality repeatedly.
Generate
<skill-directory>/scripts/chatgpt-img \
'A linocut illustration of a lighthouse in heavy rain' \
./lighthouse.png \
--size 1536x1024 \
--quality high
Edit
Single reference:
<skill-directory>/scripts/chatgpt-img edit \
./portrait.png \
'Use warm editorial lighting; preserve identity, pose, and clothing' \
./portrait-edited.png \
--quality high
Multiple references:
<skill-directory>/scripts/chatgpt-img \
--input ./portrait.png \
--input ./moodboard.png \
'Apply the moodboard lighting and palette while preserving the portrait identity' \
./portrait-styled.png
Optional masked edit:
<skill-directory>/scripts/chatgpt-img edit \
./input.png \
'Replace the masked background with a cloudy coastline' \
./output.png \
--mask ./mask.png
Important options
--model: defaults to gpt-image-2--size: supported dimensions or auto--quality: GPT Image uses auto, low, medium, or high--background: auto, transparent, or opaque--format: png, jpeg, or webp--compression: 0 through 100 for JPEG/WebP--num: number of outputs--input: repeatable reference image for edit mode--mask: optional edit mask--input-fidelity: supported by selected older GPT Image models, not gpt-image-2
Use --help and edit --help for the complete interface.
Prompting edits
State both the change and the invariants. For example, name the identity, geometry, text, logos, pose, camera angle, or materials that must remain unchanged. Describe lighting, palette, composition, and finish positively instead of relying on long negative lists.
Verification
- Check the process exit status.
- Confirm every expected output file exists and is non-empty.
- Report exact paths and any revised prompt returned by the API.
- Inspect the image with an available viewer when visual verification is part of the task.
Never expose API keys. Error output may include safe request metadata, but it must not include prompt contents or credentials.
