ai-image:generate

Generate images from a text prompt or a reference image using 20+ AI models.

Type: Async

Usage

Bash

simplified ai-image:generate [options]

Options

Flag	Type	Required	Description
--model	string	✅	Model ID (e.g. flux.flux-realism)
--prompt	string	✅	Text prompt describing the image
--aspect-ratio	string		Output aspect ratio (e.g. 16:9, 1:1, 9:16)
--count	number		Number of images to generate (default: 1)
--capability	string		Model capability: prompt · reference_image
--reference-images	string		Asset UUID(s) for reference-image models
--wait	boolean		Block until done (timeout: 180s)

Examples

Bash

# Generate from text prompt
simplified ai-image:generate \
  --model flux.flux-realism \
  --prompt "A stunning sunset over mountains, photorealistic, 8k" \
  --aspect-ratio 16:9 \
  --count 2 \
  --wait

# Style transfer from a reference image
simplified ai-image:generate \
  --model flux.flux-kontext-pro \
  --capability reference_image \
  --prompt "Transform to watercolor painting style" \
  --reference-images "ASSET_UUID" \
  --wait

# Without --wait (get task ID for later polling)
simplified ai-image:generate \
  --model flux.flux-schnell \
  --prompt "Product photo on white background"

Response (with --wait)

JSON

[
  {
    "asset_id": "asset_abc123",
    "url": "https://cdn.simplified.com/generated.png"
  }
]

Response (without --wait)

JSON

{
  "task_id": "task_xyz",
  "id": "gen_456",
  "art_variation_id": "av_789"
}

Use ai-image:status --id av_789 to poll for completion.

Available Models

Run simplified ai-image:models to get the full list with capabilities. Common models:

Model ID	Best for
flux.flux-realism	Photorealistic images
flux.flux-kontext-pro	Style transfer with reference image
flux.flux-schnell	Fast generation
google.imagen-4.0-generate-001	High quality, Google Imagen 4
openai.imgen	OpenAI image generation
ideogram.ideogram-v3-turbo	Text in images, fast
stability.diffusion	Stable Diffusion