@sethwebster/gen-image
v1.0.0
Published
Generate images from the CLI via OpenAI (gpt-image), Google Gemini, or xAI Grok
Downloads
111
Maintainers
Readme
gen-image
Zero-dependency CLI for generating images via OpenAI (gpt-image), Google Gemini, or xAI Grok.
Install
npm i -g @sethwebster/gen-image
# or one-off: npx @sethwebster/gen-image "a corgi surfing"Auth
Set whichever keys you have — provider auto-picks the first one found (openai → gemini → grok):
export OPENAI_API_KEY=...
export GEMINI_API_KEY=... # or GOOGLE_API_KEY
export XAI_API_KEY=...Usage
gen-image "a corgi surfing a wave, film photo"
gen-image "logo sketch" -p openai -q high -s 1536x1024 -b transparent -o logo.png
gen-image "city at dusk" -p gemini -a 16:9 -n 3 -o shots/
gen-image "neon samurai" -p grok -a 9:16 -r 2k --openOptions
| Flag | Applies to | Values |
| --- | --- | --- |
| -p, --provider | — | openai | gemini | grok |
| -m, --model | all | any model id (defaults: gpt-image-1, gemini-2.5-flash-image, grok-imagine-image) |
| -n, --count | all | 1–10 |
| -o, --out | all | file (logo.png) or directory (shots/); default ./<slug>-<timestamp>.<ext> |
| -s, --size | openai | 1024x1024 | 1536x1024 | 1024x1536 | auto |
| -q, --quality | openai | low | medium | high | auto |
| -f, --format | openai | png | jpeg | webp |
| -b, --background | openai | transparent | opaque | auto |
| -a, --aspect | gemini, grok | 1:1 16:9 9:16 4:3 3:4 3:2 2:3 21:9 … |
| -r, --resolution | grok | 1k | 2k |
| --open | all | open result(s) after saving (macOS) |
Run gen-image --help for the full reference.
