fal.ai Image Edit

Edit images using AI: style transfer, object removal, background changes, and more.

How It Works

• User provides image URL and editing instructions

• Script selects appropriate model

• Sends request to fal.ai API

• Returns edited image URL

Finding Models

To discover the best and latest image editing models, use the search API:

# Search for image editing models

bash /mnt/skills/user/fal-generate/scripts/search-models.sh --category "image-to-image"

Search for specific editing capabilities

bash /mnt/skills/user/fal-generate/scripts/search-models.sh --query "image editing"

bash /mnt/skills/user/fal-generate/scripts/search-models.sh --query "inpainting"

bash /mnt/skills/user/fal-generate/scripts/search-models.sh --query "object removal"

bash /mnt/skills/user/fal-generate/scripts/search-models.sh --query "background removal"

Or use the `search_models` MCP tool with relevant keywords.

## Supported Operations

| Operation | Description |

|-----------|-------------|

| Style Transfer | Apply artistic style to image |

| Object Removal | Remove objects from image |

| Background Change | Change/replace background |

| Inpainting | Fill in masked areas |

| General Edit | Instruction-based edits |

## Usage

bash /mnt/skills/user/fal-image-edit/scripts/edit-image.sh [options]

**Arguments:**

- `--image-url` - URL of image to edit (required)

- `--prompt` - Description of desired edit (required)

- `--operation` - Edit operation: `style`, `remove`, `background`, `inpaint` (default: `style`)

- `--mask-url` - URL of mask image (required for inpainting/removal)

- `--strength` - Edit strength 0.0-1.0 (default: 0.75)

**Examples:**

Style transfer

bash /mnt/skills/user/fal-image-edit/scripts/edit-image.sh \

--image-url "https://example.com/photo.jpg" \

--prompt "Convert to anime style" \

--operation style

Remove object

bash /mnt/skills/user/fal-image-edit/scripts/edit-image.sh \

--image-url "https://example.com/photo.jpg" \

--prompt "Remove the person on the left" \

--operation remove

Change background

bash /mnt/skills/user/fal-image-edit/scripts/edit-image.sh \

--image-url "https://example.com/portrait.jpg" \

--prompt "Place in a tropical beach setting" \

--operation background

Inpainting with mask

bash /mnt/skills/user/fal-image-edit/scripts/edit-image.sh \

--image-url "https://example.com/photo.jpg" \

--mask-url "https://example.com/mask.png" \

--prompt "Fill with flowers" \

--operation inpaint

## MCP Tool Alternative

Use `search_models` MCP tool or `search-models.sh` to find the best current model for each operation (style transfer, object removal, background change, inpainting), then call `mcp__fal-ai__generate` with the discovered `modelId`.

## Output

Editing image...

Model: fal-ai/flux/dev/image-to-image

Operation: style transfer

Edit complete!

Image URL: https://v3.fal.media/files/abc123/edited.png

Dimensions: 1024x1024

JSON output:

{

"images": [

{

"url": "https://v3.fal.media/files/abc123/edited.png",

"width": 1024,

"height": 1024

}

]

}

## Present Results to User

Here's your edited image:

!Edited Image

• 1024×1024 | Operation: Style Transfer

## Model Selection Tips

- **General Editing**: Search for "image editing" models. Good for instruction-based changes.

- **Style Transfer**: Search for `image-to-image` category. Adjust strength: 0.3-0.5 for subtle, 0.7-0.9 for dramatic.

- **Object Removal**: Search for "eraser" or "object removal". Some work without masks.

- **Background Change**: Search for "background" or "kontext". Look for models that preserve subject identity.

- **Inpainting**: Search for "inpainting" or "fill". Requires binary mask (white = edit area).

## Mask Tips

For inpainting and some removal tasks:

- White pixels = areas to edit

- Black pixels = areas to preserve

- Use PNG format with transparency or solid colors

- Feathered edges create smoother transitions

## Troubleshooting

### Edit Too Subtle

The edit is barely visible.

Increase the strength parameter:

--strength 0.85

### Edit Too Dramatic

The edit changed too much of the image.

Decrease the strength parameter:

--strength 0.3

### Object Not Removed

The object wasn't fully removed.

Tips:

1. Be more specific in the prompt

1. Try using an explicit mask

1. Use the inpainting model for precise control

### Background Artifacts

The new background has artifacts around the subject.

Tips:

1. Use a cleaner source image

1. Try FLUX Kontext which handles edges better

1. Adjust the strength for smoother blending