# Firered Image Edit V1.1 > FireRed Image Edit v1.1 is an updated version of FireRed Image Edit, with improved image editing capabilities. ## Overview - **Endpoint**: `https://fal.run/fal-ai/firered-image-edit-v1.1` - **Model ID**: `fal-ai/firered-image-edit-v1.1` - **Category**: image-to-image - **Kind**: inference **Tags**: firered-image-edit ## Pricing - **Price**: $0.0325 per megapixels For more details, see [fal.ai pricing](https://fal.ai/pricing). ## API Information This model can be used via our HTTP API or more conveniently via our client libraries. See the input and output schema below, as well as the usage examples. ### Input Schema The API accepts the following input parameters: - **`prompt`** (`string`, _required_): The editing instruction describing what changes to make to the image. Supports both English and Chinese instructions. - Examples: "Transform her look into a romantic Parisian evening style with a soft smoky eye in warm terracotta and bronze tones, enhanced lashes with a subtle winged effect, sun-kissed contouring that complements her olive skin, a natural rose-tinted blush on the apples of her cheeks, and lips in a sophisticated mauve-pink shade with a subtle glossy finish, while adding a touch of luminous highlighter on her cheekbones and cupid's bow to catch the warm cafe lighting." - **`image_size`** (`ImageSize | Enum`, _optional_): The size of the generated image. If None, uses the input image dimensions. - One of: ImageSize | Enum - **`num_inference_steps`** (`integer`, _optional_): The number of inference steps to perform. More steps generally produce higher quality results. Default value: `30` - Default: `30` - Range: `2` to `50` - **`seed`** (`integer`, _optional_): The same seed and the same prompt given to the same version of the model will output the same image every time. - **`guidance_scale`** (`float`, _optional_): Classifier-free guidance scale. Higher values make the model follow the prompt more closely. Default value: `4` - Default: `4` - Range: `1` to `10` - **`sync_mode`** (`boolean`, _optional_): If `True`, the media will be returned as a data URI and the output data won't be available in the request history. - Default: `false` - **`num_images`** (`integer`, _optional_): The number of images to generate. Default value: `1` - Default: `1` - Range: `1` to `4` - **`enable_safety_checker`** (`boolean`, _optional_): If set to true, the safety checker will be enabled. Default value: `true` - Default: `true` - **`output_format`** (`OutputFormatEnum`, _optional_): The format of the generated image. Default value: `"png"` - Default: `"png"` - Options: `"jpeg"`, `"png"` - **`image_urls`** (`list`, _required_): The URLs of the images to edit. Supports single image editing and multi-image references (e.g., virtual try-on, style transfer from reference, portrait makeup). - Array of string - Examples: ["https://v3b.fal.media/files/b/0a90d776/inhK3tTs7oTswxl20vSYu_d54e0deba2bd46bfb489a82892408b84.png"] - **`negative_prompt`** (`string`, _optional_): The negative prompt for the generation. Default value: `""` - Default: `""` - **`acceleration`** (`AccelerationEnum`, _optional_): The acceleration level to use for inference speed optimization. Default value: `"regular"` - Default: `"regular"` - Options: `"none"`, `"regular"`, `"high"` **Required Parameters Example**: ```json { "prompt": "Transform her look into a romantic Parisian evening style with a soft smoky eye in warm terracotta and bronze tones, enhanced lashes with a subtle winged effect, sun-kissed contouring that complements her olive skin, a natural rose-tinted blush on the apples of her cheeks, and lips in a sophisticated mauve-pink shade with a subtle glossy finish, while adding a touch of luminous highlighter on her cheekbones and cupid's bow to catch the warm cafe lighting.", "image_urls": [ "https://v3b.fal.media/files/b/0a90d776/inhK3tTs7oTswxl20vSYu_d54e0deba2bd46bfb489a82892408b84.png" ] } ``` **Full Example**: ```json { "prompt": "Transform her look into a romantic Parisian evening style with a soft smoky eye in warm terracotta and bronze tones, enhanced lashes with a subtle winged effect, sun-kissed contouring that complements her olive skin, a natural rose-tinted blush on the apples of her cheeks, and lips in a sophisticated mauve-pink shade with a subtle glossy finish, while adding a touch of luminous highlighter on her cheekbones and cupid's bow to catch the warm cafe lighting.", "num_inference_steps": 30, "guidance_scale": 4, "num_images": 1, "enable_safety_checker": true, "output_format": "png", "image_urls": [ "https://v3b.fal.media/files/b/0a90d776/inhK3tTs7oTswxl20vSYu_d54e0deba2bd46bfb489a82892408b84.png" ], "acceleration": "regular" } ``` ### Output Schema The API returns the following output format: - **`images`** (`list`, _required_): The edited image files info. - Array of Image - Examples: [{"height":2352,"url":"https://v3b.fal.media/files/b/0a90d8d7/-B_7ISYXhCNdDXe8q6F7V.png","width":1760,"content_type":"image/jpeg"}] - **`timings`** (`Timings`, _required_) - **`seed`** (`integer`, _required_): Seed of the generated Image. It will be the same value of the one passed in the input or the randomly generated that was used in case none was passed. - **`has_nsfw_concepts`** (`list`, _required_): Whether the generated images contain NSFW concepts. - Array of boolean - **`prompt`** (`string`, _required_): The prompt used for generating the image. **Example Response**: ```json { "images": [ { "height": 2352, "url": "https://v3b.fal.media/files/b/0a90d8d7/-B_7ISYXhCNdDXe8q6F7V.png", "width": 1760, "content_type": "image/jpeg" } ], "prompt": "" } ``` ## Usage Examples ### cURL ```bash curl --request POST \ --url https://fal.run/fal-ai/firered-image-edit-v1.1 \ --header "Authorization: Key $FAL_KEY" \ --header "Content-Type: application/json" \ --data '{ "prompt": "Transform her look into a romantic Parisian evening style with a soft smoky eye in warm terracotta and bronze tones, enhanced lashes with a subtle winged effect, sun-kissed contouring that complements her olive skin, a natural rose-tinted blush on the apples of her cheeks, and lips in a sophisticated mauve-pink shade with a subtle glossy finish, while adding a touch of luminous highlighter on her cheekbones and cupid's bow to catch the warm cafe lighting.", "image_urls": [ "https://v3b.fal.media/files/b/0a90d776/inhK3tTs7oTswxl20vSYu_d54e0deba2bd46bfb489a82892408b84.png" ] }' ``` ### Python Ensure you have the Python client installed: ```bash pip install fal-client ``` Then use the API client to make requests: ```python import fal_client def on_queue_update(update): if isinstance(update, fal_client.InProgress): for log in update.logs: print(log["message"]) result = fal_client.subscribe( "fal-ai/firered-image-edit-v1.1", arguments={ "prompt": "Transform her look into a romantic Parisian evening style with a soft smoky eye in warm terracotta and bronze tones, enhanced lashes with a subtle winged effect, sun-kissed contouring that complements her olive skin, a natural rose-tinted blush on the apples of her cheeks, and lips in a sophisticated mauve-pink shade with a subtle glossy finish, while adding a touch of luminous highlighter on her cheekbones and cupid's bow to catch the warm cafe lighting.", "image_urls": ["https://v3b.fal.media/files/b/0a90d776/inhK3tTs7oTswxl20vSYu_d54e0deba2bd46bfb489a82892408b84.png"] }, with_logs=True, on_queue_update=on_queue_update, ) print(result) ``` ### JavaScript Ensure you have the JavaScript client installed: ```bash npm install --save @fal-ai/client ``` Then use the API client to make requests: ```javascript import { fal } from "@fal-ai/client"; const result = await fal.subscribe("fal-ai/firered-image-edit-v1.1", { input: { prompt: "Transform her look into a romantic Parisian evening style with a soft smoky eye in warm terracotta and bronze tones, enhanced lashes with a subtle winged effect, sun-kissed contouring that complements her olive skin, a natural rose-tinted blush on the apples of her cheeks, and lips in a sophisticated mauve-pink shade with a subtle glossy finish, while adding a touch of luminous highlighter on her cheekbones and cupid's bow to catch the warm cafe lighting.", image_urls: ["https://v3b.fal.media/files/b/0a90d776/inhK3tTs7oTswxl20vSYu_d54e0deba2bd46bfb489a82892408b84.png"] }, logs: true, onQueueUpdate: (update) => { if (update.status === "IN_PROGRESS") { update.logs.map((log) => log.message).forEach(console.log); } }, }); console.log(result.data); console.log(result.requestId); ``` ## Additional Resources ### Documentation - [Model Playground](https://fal.ai/models/fal-ai/firered-image-edit-v1.1) - [API Documentation](https://fal.ai/models/fal-ai/firered-image-edit-v1.1/api) - [OpenAPI Schema](https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=fal-ai/firered-image-edit-v1.1) ### fal.ai Platform - [Platform Documentation](https://docs.fal.ai) - [Python Client](https://docs.fal.ai/clients/python) - [JavaScript Client](https://docs.fal.ai/clients/javascript)