Generate, remix, and edit images using fal.ai's AI models. Supports text-to-image generation, image-to-image remixing, and targeted inpainting/editing.
Professional AI-powered image workflows: generate, remix, and edit using fal.ai's state-of-the-art models.
uv run python fal-text-to-image "A serene mountain landscape at sunset"
uv run python fal-image-remix photo.jpg "Transform into oil painting"
uv run python fal-image-edit photo.jpg mask.png "Replace with flowers"
# Basic generation (auto-selects best model)
uv run python fal-text-to-image "Cyberpunk city at sunset"
# With specific model
uv run python fal-text-to-image -m flux-pro/v1.1-ultra "Professional portrait"
# With style reference
uv run python fal-text-to-image -i reference.jpg "Artistic landscape"
# Basic remix (auto-selects model)
uv run python fal-image-remix input.jpg "Anime style character"
# Control transformation strength (0.0=preserve, 1.0=full transformation)
uv run python fal-image-remix photo.jpg "Watercolor painting" --strength 0.6
# Premium quality
uv run python fal-image-remix -m flux-1.1-pro image.jpg "Professional studio portrait"
# Edit with mask image (white=edit, black=preserve)
uv run python fal-image-edit photo.jpg mask.png "Replace with garden"
# Auto-generate mask from text
uv run python fal-image-edit photo.jpg --mask-prompt "sky" "Make it sunset"
# Remove objects
uv run python fal-image-edit image.jpg mask.png "Remove" --strength 1.0
# General editing (no mask)
uv run python fal-image-edit photo.jpg "Enhance lighting and colors"
Get your API key from fal.ai dashboard
Set environment variable:
export FAL_KEY="your-api-key-here"
Or create .env file:
FAL_KEY=your-api-key-here
# Text-to-image
uv run python fal-text-to-image "Your prompt here"
# Image remix
uv run python fal-image-remix input.jpg "Your transformation prompt"
# Image edit
uv run python fal-image-edit input.jpg mask.png "Your edit prompt"
-i flag--seed for consistent results--mask-prompt)See SKILL.md for complete model documentation.
uv run python fal-text-to-image \
-m recraft/v3/text-to-image \
"Modern tech logo with text 'AI Labs' in minimalist blue design"
uv run python fal-text-to-image \
-m flux-pro/v1.1-ultra \
"Professional headshot of business executive, studio lighting, grey background"
uv run python fal-text-to-image \
-m flux-2 \
--seed 42 \
"Cyberpunk cityscape with neon lights"
# Subtle artistic style
uv run python fal-image-remix photo.jpg "Oil painting style" --strength 0.4
# Strong anime transformation
uv run python fal-image-remix portrait.jpg "Anime character" --strength 0.9
# Vector conversion
uv run python fal-image-remix -m recraft/v3 logo.png "Clean vector illustration"
# Remove with mask
uv run python fal-image-edit photo.jpg object_mask.png "Remove completely" --strength 1.0
# With mask image
uv run python fal-image-edit room.jpg region_mask.png "Add modern sofa"
# With auto-generated mask
uv run python fal-image-edit landscape.jpg --mask-prompt "sky" "Golden hour sunset"
uv run python fal-image-edit -m flux-2/redux photo.jpg "Enhance lighting and saturation"
Combine all three tools for complete image workflows:
# 1. Generate base image
uv run python fal-text-to-image "Modern office space" -o base.png
# 2. Apply artistic style
uv run python fal-image-remix base.png "Cyberpunk aesthetic" -o styled.png
# 3. Edit specific details
uv run python fal-image-edit styled.png --mask-prompt "desk" "Add holographic display"
Arguments:
PROMPT Text description of image
Options:
-m, --model TEXT Model selection
-i, --image TEXT Reference image for style transfer
-o, --output TEXT Output filename
-s, --size TEXT Image size (1024x1024, landscape_16_9, etc.)
--seed INTEGER Random seed
--steps INTEGER Inference steps
--guidance FLOAT Guidance scale
--help Show help
Arguments:
INPUT_IMAGE Path or URL to source image
PROMPT How to transform the image
Options:
-m, --model TEXT Model selection
-o, --output TEXT Output filename
-s, --strength FLOAT Transformation strength 0.0-1.0 (default: 0.75)
--guidance FLOAT Guidance scale (default: 7.5)
--seed INTEGER Random seed
--steps INTEGER Inference steps
--help Show help
Arguments:
INPUT_IMAGE Path or URL to source image
MASK_IMAGE Path or URL to mask (white=edit, black=preserve) [optional]
PROMPT How to edit the masked region
Options:
-m, --model TEXT Model selection
-o, --output TEXT Output filename
--mask-prompt TEXT Generate mask from text (no mask image needed)
-s, --strength FLOAT Edit strength 0.0-1.0 (default: 0.95)
--guidance FLOAT Guidance scale (default: 7.5)
--seed INTEGER Random seed
--steps INTEGER Inference steps
--help Show help
All tools save images to outputs/ directory with:
Monitor usage at fal.ai dashboard
fal-text-to-image/
├── SKILL.md # Full documentation
├── README.md # This file
├── fal-text-to-image # Text-to-image generation script
├── fal-image-remix # Image-to-image remixing script
├── fal-image-edit # Image editing/inpainting script
├── pyproject.toml # Dependencies
├── .env.example # Environment template
├── .gitignore
├── references/
│ └── model-comparison.md # Detailed model comparison
└── outputs/ # Generated images (created on first run)
| Issue | Solution | Tool |
|-------|----------|------|
| FAL_KEY not set | Export FAL_KEY or create .env file | All |
| Model not found | Check model name in SKILL.md | All |
| Image upload fails | Check file exists and is readable | Remix, Edit |
| Mask not working | Verify mask is grayscale PNG (white=edit) | Edit |
| Transformation too strong | Reduce --strength value | Remix, Edit |
| Generation timeout | Try faster model or wait longer | All |
Managed automatically by uv:
This skill is part of the Claude Code skills ecosystem.
npx skills add ArcherRyanco/fal-text-to-image下载完整 Skill 目录，包含 SKILL.md 及所有相关文件
Generate or edit images via Gemini 3 Pro Image (Nano Banana Pro).
Batch-generate images via OpenAI Images API. Random prompt sampler + `index.html` gallery.
Generate spectrograms and feature-panel visualizations from audio with the songsee CLI.
Extract frames or short clips from videos using ffmpeg.
Search GIF providers with CLI/TUI, download results, and extract stills/sheets.
Category:media-generate