// Generate high-quality images from text prompts using fal.ai's text-to-image models. Supports intelligent model selection, style transfer, and professional-grade outputs.
| name | fal-text-to-image |
| description | Generate high-quality images from text prompts using fal.ai's text-to-image models. Supports intelligent model selection, style transfer, and professional-grade outputs. |
Generate production-quality images from text prompts using fal.ai's state-of-the-art text-to-image models including FLUX, Recraft V3, Imagen4, and more.
Trigger when user:
uv run python fal-text-to-image "A cyberpunk city at sunset with neon lights"
uv run python fal-text-to-image -m flux-pro/v1.1-ultra "Professional headshot of a business executive"
uv run python fal-text-to-image -i reference.jpg "A mountain landscape" -m flux-2/lora/edit
The script intelligently selects the best model based on task context:
fal-ai/flux-pro/v1.1-ultrafal-ai/recraft/v3/text-to-imagefal-ai/flux-2fal-ai/flux-2/lora-i flagfal-ai/flux-2/lora/editfal-ai/imagen4/previewfal-ai/stable-diffusion-v35-largefal-ai/ideogram/v2fal-ai/bria/text-to-image/3.2uv run python fal-text-to-image [OPTIONS] PROMPT
Arguments:
PROMPT Text description of the image to generate
Options:
-m, --model TEXT Model to use (see model list above)
-i, --image TEXT Path or URL to reference image for style transfer
-o, --output TEXT Output filename (default: generated_image.png)
-s, --size TEXT Image size (e.g., "1024x1024", "landscape_16_9")
--seed INTEGER Random seed for reproducibility
--steps INTEGER Number of inference steps (model-dependent)
--guidance FLOAT Guidance scale (higher = more prompt adherence)
--help Show this message and exit
Before first use, set your fal.ai API key:
export FAL_KEY="your-api-key-here"
Or create a .env file in the skill directory:
FAL_KEY=your-api-key-here
Get your API key from: https://fal.ai/dashboard/keys
uv run python fal-text-to-image \
-m flux-pro/v1.1-ultra \
"Professional headshot of a business executive in modern office" \
-s 2048x2048
uv run python fal-text-to-image \
-m recraft/v3/text-to-image \
"Modern tech startup logo with text 'AI Labs' in minimalist style"
uv run python fal-text-to-image \
-m flux-2/lora/edit \
-i artistic_style.jpg \
"Portrait of a woman in a garden"
uv run python fal-text-to-image \
-m flux-2 \
--seed 42 \
"Futuristic cityscape with flying cars"
The script automatically selects the best model when -m is not specified:
-i provided: Uses flux-2/lora/edit for style transferrecraft/v3/text-to-imageflux-pro/v1.1-ultrarecraft/v3/text-to-imageflux-2 for general purposeGenerated images are saved with metadata:
| Problem | Solution |
|---|---|
FAL_KEY not set | Export FAL_KEY environment variable or create .env file |
Model not found | Check model name against supported list |
Image reference fails | Ensure image path/URL is accessible |
Generation timeout | Some models take longer; wait or try faster model |
Rate limit error | Check fal.ai dashboard for usage limits |
flux-2 or stable-diffusion-v35-large for general useflux-pro/v1.1-ultra only when high-res is requiredfal-text-to-image/
├── SKILL.md # This file
├── pyproject.toml # Dependencies (uv)
├── fal-text-to-image # Main executable script
├── references/
│ └── model-comparison.md # Detailed model benchmarks
└── outputs/ # Generated images (created on first run)
Managed via uv:
fal-client: Official fal.ai Python SDKpython-dotenv: Environment variable managementpillow: Image handling and EXIF metadataclick: CLI interface--seed for consistent results during iteration