Showcase
Each example shows real output produced by imgen itself, from files in the project repository. Input on the left, output on the right.
Command reference
examples/help.txtDetail: Command reference →imgen --helpCLI tool to generate images via the Replicate API
Usage: imgen [OPTIONS] [PROMPT]
Arguments:
[PROMPT] Text prompt for image generation (ignored when --prompt-file is used)
Options:
--prompt-file <FILE> JSON file containing an array of jobs
--model <MODEL> Replicate model in "owner/name" format [default: black-forest-labs/flux-1.1-pro]
--width <WIDTH> Output width in pixels [default: 1024]
--height <HEIGHT> Output height in pixels [default: 768]
--out <OUT> Output file path (only used for single-prompt mode) [default: output.png]
--webp [<WEBP>] Convert output to WebP with given quality (0-100). Omit value for default 80
-h, --help Print help
-V, --version Print versionMissing API token
examples/missing-token.txtDetail: Missing API token →env -u REPLICATE_API_TOKEN imgen "A sunset over the ocean"Error: Environment variable REPLICATE_API_TOKEN is not set
Caused by:
environment variable not found
exit code 1No prompt given
examples/missing-prompt.txtDetail: No prompt given →imgenError: Either a prompt argument or --prompt-file is required exit code 1
Batch job without output path
examples/missing-out.txtDetail: Batch job without output path →[
{ "prompt": "A mountain landscape", "out": "images/mountain.png" },
{ "prompt": "A cityscape at night" }
]Error: Failed to parse prompt file examples/prompt-files/missing-out.json
Caused by:
0: Failed to parse jobs array
1: missing field `out`
exit code 1Empty batch
examples/empty-batch.txtDetail: Empty batch →{
"defaults": { "model": "black-forest-labs/flux-schnell" },
"jobs": []
}Error: Prompt file contains no jobs exit code 1
Gallery: Laptop with a terminal
examples/gallery/ki-bilder-kommandozeile-mac-api-lokal.webpDetail: Gallery: Laptop with a terminal →imgen 'Bold glowing title text at top: "KI-Bilder per Kommandozeile". Vibrant 3D isometric illustration of a sleek laptop with a terminal console on screen, surrounded by colorful AI-generated artwork bursting out of the screen like magic portals, floating brushstrokes, light particles, and holographic imagery swirling around. Dark moody background with neon accent colors purple and cyan, digital art style, dramatic lighting' \
--model ideogram-ai/ideogram-v3-quality \
--width 1000 --height 1080 \
--out ki-bilder-kommandozeile-mac-api-lokal.png
Gallery: Server rack and clouds
examples/gallery/cloud-exit-strategie-souveraene-architektur.webpDetail: Gallery: Server rack and clouds →imgen 'Bold glowing title text at top: "Raus aus der Cloud?". 3D isometric server rack with glowing escape route arrows pointing outward, a European map hologram floating behind it, data streams breaking free from cloud symbols. Dark background with electric blue and red neon accents, digital art style, dramatic lighting' \
--model ideogram-ai/ideogram-v3-quality \
--width 1000 --height 1080 \
--out cloud-exit-strategie-souveraene-architektur.png
Gallery: Staircase of code blocks
examples/gallery/supply-chain-security-karriere-entwickler.webpDetail: Gallery: Staircase of code blocks →imgen 'Bold glowing title text at top: "Security als Karrierepfad". 3D isometric rising staircase made of code blocks and shield icons, each step glowing brighter toward the top, terminal windows and lock symbols floating alongside the ascending path. Dark background with electric blue and green neon accents, digital art style, dramatic lighting' \
--model ideogram-ai/ideogram-v3-quality \
--width 1000 --height 1080 \
--out supply-chain-security-karriere-entwickler.png
Gallery: Grid of UI components
examples/gallery/warum-sich-design-systems-rechnen.webpDetail: Gallery: Grid of UI components →imgen 'Bold glowing title text at top: "Design Systems rechnen sich". 3D isometric grid of UI components — buttons, cards, color swatches, typography tokens — floating in organized layers, connected by glowing lines forming a system. Dark background with cyan and magenta neon accents, flat vector art style, dramatic lighting' \
--model ideogram-ai/ideogram-v3-quality \
--width 1000 --height 1080 \
--out warum-sich-design-systems-rechnen.png
Gallery: Stone blocks turning into puzzle pieces
examples/gallery/tod-der-vererbung-composition-traits-protokolle.webpDetail: Gallery: Stone blocks turning into puzzle pieces →imgen 'Bold glowing title text at top: "Der Tod der Vererbung". Crumbling 3D class hierarchy tree shattering into fragments, modern glowing composition blocks and trait puzzle pieces assembling from the debris, energy sparks at the transition point. Dark background with red and electric blue neon accents, digital art style, dramatic lighting' \
--model ideogram-ai/ideogram-v3-quality \
--width 1000 --height 1080 \
--out tod-der-vererbung-composition-traits-protokolle.png
Gallery: Rocket and old machine
examples/gallery/modernisierung-ist-kein-ziel.webpDetail: Gallery: Rocket and old machine →imgen 'Bold glowing title text at top: "Modernisierung ist kein Ziel". 3D isometric illustration of a shiny new rocket standing idle next to a reliable old machine that is actually running and producing output, sparks and gears in motion around the old machine. Dark background with amber and electric blue neon accents, digital art style, dramatic lighting' \
--model ideogram-ai/ideogram-v3-quality \
--width 1000 --height 1080 \
--out modernisierung-ist-kein-ziel.png
Gallery: Conveyor belt with a stop sign
examples/gallery/ki-slop-test-wann-keine-ki-nutzen.webpDetail: Gallery: Conveyor belt with a stop sign →imgen 'Bold glowing title text at top: "Der KI-Slop-Test". 3D illustration of a conveyor belt producing identical generic documents, a large red STOP sign slamming down on the belt, rejected AI slop flying off into a glowing trash vortex. Dark background with red and purple neon accents, digital art style, dramatic lighting' \
--model ideogram-ai/ideogram-v3-quality \
--width 1000 --height 1080 \
--out ki-slop-test-wann-keine-ki-nutzen.png