fal.ai Image Generation & Editing Skill

Professional AI-powered image workflows using fal.ai's state-of-the-art models including FLUX, Recraft V3, Imagen4, and more.

Three Modes of Operation

1. Text-to-Image (fal-text-to-image)

Generate images from scratch using text prompts

2. Image Remix (fal-image-remix)

Transform existing images while preserving composition

3. Image Edit (fal-image-edit)

Targeted inpainting and masked editing

When to Use This Skill

Trigger when user:

• - Requests image generation from text descriptions
• Wants to transform/remix existing images with AI
• Needs to edit specific regions of images (inpainting)
• Wants to create images with specific styles (vector, realistic, typography)
• Needs high-resolution professional images (up to 2K)
• Wants to use a reference image for style transfer
• Mentions specific models like FLUX, Recraft, or Imagen
• Asks for logo, poster, or brand-style image generation
• Needs object removal or targeted modifications

Quick Start

Text-to-Image: Generate from Scratch

CODEBLOCK0

Image Remix: Transform Existing Images

CODEBLOCK1

Image Edit: Targeted Modifications

CODEBLOCK2

Model Selection Guide

The script intelligently selects the best model based on task context:

flux-pro/v1.1-ultra (Default for High-Res)

• - Best for: Professional photography, high-resolution outputs (up to 2K)
• Strengths: Photo realism, professional quality
• Use when: User needs publication-ready images
• Endpoint: INLINECODE0

recraft/v3/text-to-image (SOTA Quality)

• - Best for: Typography, vector art, brand-style images, long text
• Strengths: Industry-leading benchmark scores, precise text rendering
• Use when: Creating logos, posters, or text-heavy designs
• Endpoint: INLINECODE1

flux-2 (Best Balance)

• - Best for: General-purpose image generation
• Strengths: Enhanced realism, crisp text, native editing
• Use when: Standard image generation needs
• Endpoint: INLINECODE2

flux-2/lora (Custom Styles)

• - Best for: Domain-specific styles, fine-tuned variations
• Strengths: Custom style adaptation
• Use when: User wants specific artistic styles
• Endpoint: INLINECODE3

flux-2/lora/edit (Style Transfer)

• - Best for: Image-to-image editing with style references
• Strengths: Specialized style transfer
• Use when: User provides reference image with -i flag
• Endpoint: INLINECODE5

imagen4/preview (Google Quality)

• - Best for: High-quality general images
• Strengths: Google's highest quality model
• Use when: User specifically requests Imagen or Google models
• Endpoint: INLINECODE6

stable-diffusion-v35-large (Typography & Style)

• - Best for: Complex prompts, typography, style control
• Strengths: Advanced prompt understanding, resource efficiency
• Use when: Complex multi-element compositions
• Endpoint: INLINECODE7

ideogram/v2 (Typography Specialist)

• - Best for: Posters, logos, text-heavy designs
• Strengths: Exceptional typography, realistic outputs
• Use when: Text accuracy is critical
• Endpoint: INLINECODE8

bria/text-to-image/3.2 (Commercial Safe)

• - Best for: Commercial projects requiring licensed training data
• Strengths: Safe for commercial use, excellent text rendering
• Use when: Legal/licensing concerns matter
• Endpoint: INLINECODE9

Command-Line Interface

CODEBLOCK3

Authentication Setup

Before first use, set your fal.ai API key:

CODEBLOCK4

Or create a .env file in the skill directory:
CODEBLOCK5

Get your API key from: https://fal.ai/dashboard/keys

Advanced Examples

High-Resolution Professional Photo

CODEBLOCK6

Logo/Typography Design

CODEBLOCK7

Style Transfer from Reference

CODEBLOCK8

Reproducible Generation

CODEBLOCK9

Model Selection Logic

The script automatically selects the best model when -m is not specified:

1. 1. If -i provided: Uses flux-2/lora/edit for style transfer
2. If prompt contains typography keywords (logo, text, poster, sign): Uses INLINECODE14
3. If prompt suggests high-res needs (professional, portrait, headshot): Uses INLINECODE15
4. If prompt mentions vector/brand: Uses INLINECODE16
5. Default: Uses flux-2 for general purpose

Output Format

Generated images are saved with metadata:

• - Filename includes timestamp and model name
• EXIF data stores prompt, model, and parameters
• Console displays generation time and cost estimate

Troubleshooting

Problem	Solution
INLINECODE18	Export FAL_KEY environment variable or create .env file
INLINECODE19

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 |

Cost Optimization

• - Free tier: FLUX.2 offers 100 free requests (expires Dec 25, 2025)
• Pay per use: FLUX Pro charges per megapixel
• Budget option: Use flux-2 or stable-diffusion-v35-large for general use
• Premium: Use flux-pro/v1.1-ultra only when high-res is required

Image Remix: Model Selection Guide

Available models for image-to-image remixing:

flux-2/dev (Default, Free)

• - Best for: General remixing, style transfer, fast iteration
• Strengths: Balanced quality/speed, 100 free requests
• Use when: Standard remixing needs
• Endpoint: INLINECODE26

flux-pro (Premium Quality)

• - Best for: Professional remixing, high-quality outputs
• Strengths: Superior quality, realistic transformations
• Use when: Professional or publication-ready remixes
• Endpoint: INLINECODE27

flux-1.1-pro (Ultra Premium)

• - Best for: Highest quality remixing with maximum detail
• Strengths: Ultra-high quality, exceptional detail preservation
• Use when: Premium projects requiring best possible output
• Endpoint: INLINECODE28

recraft/v3 (Vector/Illustration)

• - Best for: Vector style, brand imagery, illustration remixing
• Strengths: Clean vector outputs, brand-style transformations
• Use when: Converting to illustration or vector style
• Endpoint: INLINECODE29

stable-diffusion-v35 (Artistic)

• - Best for: Artistic styles, painting effects, creative remixing
• Strengths: Strong artistic style application
• Use when: Artistic or stylized transformations
• Endpoint: INLINECODE30

Image Remix: Command-Line Interface

CODEBLOCK10

Remix Strength Guide

The --strength parameter controls transformation intensity:

Strength	Effect	Use Case
0.3-0.5	Subtle changes	Minor color adjustments, lighting tweaks
0.5-0.7

Moderate changes | Style hints while preserving details |
| 0.7-0.85 | Strong changes | Clear style transfer, significant transformation |
| 0.85-1.0 | Maximum changes | Complete style overhaul, dramatic transformation |

Remix Examples

CODEBLOCK11

Image Edit: Model Selection Guide

Available models for targeted editing and inpainting:

flux-2/redux (General Editing)

• - Best for: General image editing without masks
• Strengths: Fast, balanced, good for overall adjustments
• Use when: No specific region targeting needed
• Endpoint: INLINECODE32

flux-2/fill (Inpainting, Default)

• - Best for: Masked region editing, object removal, filling
• Strengths: Seamless inpainting, natural blending
• Use when: Editing specific masked regions
• Endpoint: INLINECODE33

flux-pro-v11/fill (Premium Inpainting)

• - Best for: Professional inpainting with highest quality
• Strengths: Superior quality, professional results
• Use when: Premium quality inpainting required
• Endpoint: INLINECODE34

stable-diffusion-v35/inpainting (Artistic Inpainting)

• - Best for: Artistic edits, creative inpainting
• Strengths: Strong artistic control, detailed generation
• Use when: Artistic or stylized edits
• Endpoint: INLINECODE35

ideogram/v2/edit (Realistic Editing)

• - Best for: Realistic modifications, precise edits
• Strengths: High realism, precise control
• Use when: Realistic edits required
• Endpoint: INLINECODE36

recraft/v3/svg (Vector Editing)

• - Best for: Vector style edits, clean illustrations
• Strengths: Clean vector outputs, illustration style
• Use when: Vector or illustration edits
• Endpoint: INLINECODE37

Image Edit: Command-Line Interface

CODEBLOCK12

Edit Strength Guide

The --strength parameter controls edit intensity:

Strength	Effect	Use Case
0.5-0.7	Subtle edits	Minor touch-ups, color adjustments
0.7-0.9

Moderate edits | Clear modifications while blending naturally |
| 0.9-1.0 | Strong edits | Complete replacement, object removal |

Creating Mask Images

Mask images define edit regions:

• - White (255): Areas to edit/modify
• Black (0): Areas to preserve unchanged
• Gray: Partial blending (proportional to brightness)

Create masks using:

• - Image editors (GIMP, Photoshop, Krita)
• Paint tools (select and fill with white/black)
• Text-based prompts (--mask-prompt flag)

Edit Examples

CODEBLOCK13

File Structure

CODEBLOCK14

Dependencies

Managed via uv:

• - fal-client: Official fal.ai Python SDK
• INLINECODE42: Environment variable management
• INLINECODE43: Image handling and EXIF metadata
• INLINECODE44: CLI interface

Best Practices

General

1. 1. Model Selection: Let scripts auto-select unless you have specific needs
2. Prompt Engineering: Be specific and descriptive for better outputs
3. Cost Awareness: Monitor usage on fal.ai dashboard
4. Reproducibility: Use --seed for consistent results during iteration

Text-to-Image

1. 1. Reference Images: Use high-quality references for best style transfer results
2. Size Selection: Match aspect ratio to intended use (square, landscape, portrait)
3. Model Choice: Use recraft/v3 for typography, flux-pro for professional photography

Image Remix

1. 1. Strength Tuning: Start with default (0.75), adjust based on desired transformation
2. Source Quality: Higher quality source images produce better remixes
3. Iteration: Use --seed to iterate on same generation with different prompts
4. Balance: Lower strength preserves more detail, higher creates more dramatic changes

Image Edit

1. 1. Mask Quality: Clean, well-defined masks produce better results
2. Mask Creation: Use image editors for precise control, --mask-prompt for quick tests
3. Blending: Use gray tones in masks for smooth transitions
4. Edit Strength: Use 0.95+ for object removal, 0.7-0.9 for modifications
5. Test First: Try --mask-prompt before creating detailed masks
6. Multiple Edits: Edit in stages rather than all at once for complex modifications

Resources

• - fal.ai Documentation: https://docs.fal.ai/
• Model Playground: https://fal.ai/explore/search
• API Keys: https://fal.ai/dashboard/keys
• Pricing: https://fal.ai/pricing

Workflow Examples

Complete Image Creation Pipeline

CODEBLOCK15

Iterative Refinement

CODEBLOCK16

Object Removal and Replacement

CODEBLOCK17

Troubleshooting

Problem	Solution	Tool
INLINECODE46	Export FAL_KEY or create .env file	All
INLINECODE47

Check model name in documentation | 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 | | Transformation too weak | Increase --strength value | Remix, Edit | | Mask-prompt not precise | Create manual mask in image editor | Edit | | Generation timeout | Try faster model or wait longer | All | | Rate limit error | Check fal.ai dashboard usage limits | All |

Limitations

General

• - Requires active fal.ai API key
• Subject to fal.ai rate limits and quotas
• Internet connection required
• Some models have usage costs (check pricing)

Text-to-Image

• - Image reference features limited to specific models
• Typography quality varies by model

Image Remix

• - Source image quality affects output quality
• Extreme strength values may introduce artifacts
• Some styles work better with specific models

Image Edit

• - Mask quality critical for seamless results
• Auto-generated masks (--mask-prompt) less precise than manual masks
• Complex edits may require multiple passes
• Some models don't support all editing features