/image-generation

name: image-generation
description: Generate images using Google Gemini (gemini-3-pro-image-preview). Requires GEMINI_API_KEY.
envVars:
  - name: GEMINI_API_KEY
    description: Google AI Studio / Gemini API key
    required: true

Image Generation

Generate images using Google Gemini (`gemini-3-pro-image-preview`) for both text-to-image and image-to-image workflows.

Use the packaged CLI:

middleman image generate \
  --prompt "a cute robot bee in a garden" \
  --output "/path/to/output.png"

Image-to-image generation is supported with repeated `--input-image` flags:

middleman image generate \
  --prompt "turn this sketch into a painted poster with a limited teal and coral palette" \
  --input-image "/path/to/sketch.png" \
  --input-image "/path/to/reference.jpg" \
  --output "/path/to/output.png"

Options

• `--prompt` (required): text description of the image to generate
• `--output` (required): output file path (extension auto-detected when omitted)
• `--input-image` (optional, repeatable): local source image(s) to send alongside the prompt
• `--aspect-ratio` (optional): aspect ratio like `16:9`, `1:1`, `4:3`
• `--size` (optional): image size, default `1K`

Output

The script prints JSON:

• Success: `{ "ok": true, "file": "/path/to/output.png", "mimeType": "image/png" }`
• Failure: `{ "ok": false, "error": "..." }`