# Firered Image Edit > FireRed Image Edit is FireRed's state of the art open source editing model, re-trained from Qwen Image Edit 2509. ## Overview - **Endpoint**: `https://fal.run/fal-ai/firered-image-edit` - **Model ID**: `fal-ai/firered-image-edit` - **Category**: image-to-image - **Kind**: inference **Tags**: image-editing, firered ## 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: "Move the whirling dervishes to this colorful room" - **`image_size`** (`ImageSize | Enum`, _optional_): The size of the generated image. If None, uses the input image dimensions. - One of: ImageSize | Enum - Examples: {"width":1536,"height":768} - **`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). - Array of string - Examples: ["https://v3b.fal.media/files/b/0a8ed7f7/ElaLDgkUJiEazYH90eqJ3.jpg","https://v3b.fal.media/files/b/0a8ed7f9/4keTvi5q_yV4pCIUzAyFR.jpg"] - **`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": "Move the whirling dervishes to this colorful room", "image_urls": [ "https://v3b.fal.media/files/b/0a8ed7f7/ElaLDgkUJiEazYH90eqJ3.jpg", "https://v3b.fal.media/files/b/0a8ed7f9/4keTvi5q_yV4pCIUzAyFR.jpg" ] } ``` **Full Example**: ```json { "prompt": "Move the whirling dervishes to this colorful room", "image_size": { "width": 1536, "height": 768 }, "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/0a8ed7f7/ElaLDgkUJiEazYH90eqJ3.jpg", "https://v3b.fal.media/files/b/0a8ed7f9/4keTvi5q_yV4pCIUzAyFR.jpg" ], "acceleration": "regular" } ``` ### Output Schema The API returns the following output format: - **`images`** (`list`, _required_): The edited image files info. - Array of Image - Examples: [{"url":"https://v3b.fal.media/files/b/0a8ed7fa/pHsp1KWzqkNNYfAcZ_bkY.jpg","width":1376,"content_type":"image/jpeg","height":768}] - **`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": [ { "url": "https://v3b.fal.media/files/b/0a8ed7fa/pHsp1KWzqkNNYfAcZ_bkY.jpg", "width": 1376, "content_type": "image/jpeg", "height": 768 } ], "prompt": "" } ``` ## Usage Examples ### cURL ```bash curl --request POST \ --url https://fal.run/fal-ai/firered-image-edit \ --header "Authorization: Key $FAL_KEY" \ --header "Content-Type: application/json" \ --data '{ "prompt": "Move the whirling dervishes to this colorful room", "image_urls": [ "https://v3b.fal.media/files/b/0a8ed7f7/ElaLDgkUJiEazYH90eqJ3.jpg", "https://v3b.fal.media/files/b/0a8ed7f9/4keTvi5q_yV4pCIUzAyFR.jpg" ] }' ``` ### 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", arguments={ "prompt": "Move the whirling dervishes to this colorful room", "image_urls": ["https://v3b.fal.media/files/b/0a8ed7f7/ElaLDgkUJiEazYH90eqJ3.jpg", "https://v3b.fal.media/files/b/0a8ed7f9/4keTvi5q_yV4pCIUzAyFR.jpg"] }, 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", { input: { prompt: "Move the whirling dervishes to this colorful room", image_urls: ["https://v3b.fal.media/files/b/0a8ed7f7/ElaLDgkUJiEazYH90eqJ3.jpg", "https://v3b.fal.media/files/b/0a8ed7f9/4keTvi5q_yV4pCIUzAyFR.jpg"] }, 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) - [API Documentation](https://fal.ai/models/fal-ai/firered-image-edit/api) - [OpenAPI Schema](https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=fal-ai/firered-image-edit) ### 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)