cluesmith/codev/generate-image

generate-image - AI Image Generation

Uses Google Gemini to generate images from text prompts.

Synopsis

codev generate-image "<prompt>" [options]

Note: this is a codev subcommand, not standalone.

All flags

-o, --output <file>        Output file path (default: output.png)
-r, --resolution <res>     Resolution: 1K, 2K, 4K (default: 1K)
-a, --aspect <ratio>       Aspect ratio (default: 1:1)
--ref <image>              Reference image (repeatable, max 14)
-p, --provider <name>      Provider name (default: gemini)

Aspect ratios

1:1 | 16:9 | 9:16 | 3:4 | 4:3 | 3:2 | 2:3

Examples

codev generate-image "A sunset over mountains"
codev generate-image "A futuristic city" -r 4K -a 16:9 -o city.png
codev generate-image "Same style but with cats" --ref style.png --ref layout.png
codev generate-image prompt.txt -o result.png    # Prompt from .txt file

Notes

• Prompt must be quoted if it contains spaces
• Prompt can be a .txt file path (auto-detected by extension)
• Reference images must exist on disk
• Requires GEMINI_API_KEY or GOOGLE_API_KEY environment variable

Alternative provider: Atlas Cloud

-p atlas generates through Atlas Cloud, which serves the same Nano Banana Pro model over a submit-then-poll REST API. Useful when a Google AI Studio key is not available. Requires ATLASCLOUD_API_KEY; the default provider is unchanged.

codev generate-image "A sunset over mountains" -p atlas -a 16:9

Measured differences on that path:

• -a/--aspect works (1:1 returns 1024x1024, 16:9 returns 1376x768).
• -r/--resolution has no equivalent field; a note is printed and the model's

default resolution comes back.

• --ref is not supported (text-to-image only) and exits with an error rather

than silently ignoring the images.

• The model returns JPEG, so the output file is named after its actual bytes

instead of writing JPEG into the default output.png.

MuAPI provider

-p muapi uses MuAPI's Nano Banana Pro endpoint with the same aspect-ratio and resolution controls. Set MUAPI_API_KEY (or MU_API_KEY) using the MuAPI access keys page. Reference images are uploaded to MuAPI and sent to the edit endpoint; returned media is downloaded only over HTTPS.

codev generate-image "A sunset over mountains" -p muapi -a 16:9
codev generate-image "Keep the subject, change the lighting" -p muapi --ref subject.png

The provider submits a job, polls the MuAPI image API, and writes the returned image locally. Polling and individual requests are bounded, and the API key is never sent to the returned media host.