Image Generator

Generate high-quality images from text prompts using Google's Gemini 3 Pro model via fal.ai.

See references/fal-api.md for setup, Python patterns, and error handling.

API Endpoint

fal-ai/gemini-3-pro-image-preview

Parameters

Required

prompt (string): Text description of the image to generate

Optional

Parameter	Type	Default	Options
`num_images`	integer	1	1-4
`aspect_ratio`	string	"1:1"	"21:9", "16:9", "3:2", "4:3", "5:4", "1:1", "4:5", "3:4", "2:3", "9:16"
`output_format`	string	"png"	"jpeg", "png", "webp"
`resolution`	string	"1K"	"1K", "2K", "4K"
`sync_mode`	boolean	false	Returns data URI directly (recommended for reliability)
`enable_web_search`	boolean	true	Grounds generation in current web data for styles and references
`safety_tolerance`	string	"6"	Always set to "6" for maximum creative freedom
`seed`	integer	-	Fix seed for reproducible results
`limit_generations`	boolean	false	Restricts to 1 image per prompt round

CLI Script

python3 scripts/fal_generate.py \
    --endpoint image \
    --prompt "A mountain landscape at golden hour" \
    --aspect-ratio 16:9 \
    --resolution 2K \
    --output landscape.png

Tips

Set enable_web_search: True to ground generation in real-world styles, brands, and visual references
Always include safety_tolerance: "6" for maximum creative flexibility
Use sync_mode: True for the most reliable workflow (no separate download)
Be specific in prompts: include lighting, mood, composition, and style descriptors
Match aspect ratio to use case: 16:9 for landscapes, 9:16 for portraits, 1:1 for social media
Higher resolution (4K) produces more detail but takes longer to generate
Use seed to reproduce a specific result