image-gen

Image Generator

Generate or edit images via Maxgent FAL API proxy.

Prerequisites

1. MAX_API_KEY environment variable (auto-injected by Max)
2. Bun 1.0+ (built into Max)

Default Routing

1. Text-to-image (default): fal-ai/nano-banana-pro
2. Image editing (default): fal-ai/nano-banana-pro/edit

Usage

bun skills/image-gen/image-gen.js \
  --model MODEL --prompt "PROMPT" --aspect-ratio RATIO \
  --num-images N --output-dir DIR \
  [--input-image PATH] [--output-format FORMAT] \
  [--seed N] [--guidance-scale X] [--steps N]

Parameters:

• --model: auto (recommended), gpt-image-1.5, nano-banana-pro, flux-dev
• --prompt: image description or editing instruction
• --aspect-ratio: 1:1, 4:3, 3:4, 16:9, 9:16
• --num-images: number of images to generate (default 1)
• --output-dir: output directory — default to $MAX_PROJECT_PATH (the user's project root)
• --input-image: optional, for image editing mode
• --output-format: png, jpg, webp (default png)
• --seed: random seed for reproducibility
• --guidance-scale: guidance scale for supported models
• --steps: number of inference steps for supported models

Examples

# Default routing, text-to-image
bun skills/image-gen/image-gen.js --model auto --prompt "a cat under the starry sky" --aspect-ratio "1:1" --output-dir "$MAX_PROJECT_PATH"

# Specify model
bun skills/image-gen/image-gen.js --model gpt-image-1.5 --prompt "modern building facade, cinematic" --aspect-ratio "16:9" --num-images 2 --output-dir "$MAX_PROJECT_PATH"

# Image editing
bun skills/image-gen/image-gen.js --model auto --prompt "change background to a beach at sunset" --aspect-ratio "1:1" --output-dir "$MAX_PROJECT_PATH" --input-image "/path/to/input.jpg"

Instructions

1. Check that MAX_API_KEY exists.
2. Use AskUserQuestion to collect: edit or generate, prompt, aspect ratio, count. Default output path to $MAX_PROJECT_PATH.
3. Run the script and wait for result.
4. On success, report the output path.
5. On failure:
   • HTTP 402 (insufficient credits): Stop immediately. Do NOT retry. Tell the user their API credits are exhausted.
   • Other errors: retry once with a different model or simplified prompt. If it fails again, stop and report the error.