# Fibo 2.0 Edit > Fibo 2.0 Edit makes targeted, instruction-based edits from up to four images. Background swaps, product restaging, keeping the product true to the original. Trained only on licensed data, with clear commercial rights. ## Overview - **Endpoint**: `https://fal.run/bria/fibo-2/edit` - **Model ID**: `bria/fibo-2/edit` - **Category**: image-to-image - **Kind**: inference **Description**: Fibo 2.0 Edit is Bria's image editing model for background changes, product restaging, campaign adaptations, and reference-guided variations. Bria states that the model is trained on licensed data. The endpoint accepts one to four images in image_urls: the source image first, followed by up to three references. Instructions can refer to them as , , and so on. Free-form instructions are expanded into a VGL document, which is returned with the edited image and can be reused directly. Single-image requests keep the source aspect ratio. An optional mask marks the area to regenerate in white and the area to preserve in black; it must match the source image size. Masked output retains the source dimensions and the original pixels outside the mask. Masks are supported only with a single image. Multi-image requests support 21 output aspect ratios at approximately one megapixel. Left unset, the output keeps the first image's aspect ratio. A seed controls reproducibility, and sync mode returns the image directly in the response. For generation from a text prompt, use Fibo 2.0 Generate. **Tags**: image editing, instruction-based image editing, reference images, e-commerce, product photography, background swap, product restaging, campaign localization, masked editing, commercial use, licensed AI ## Pricing Your request will cost $0.04 per image 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: - **`image_urls`** (`list`, _required_): 1-4 images to edit (files or URLs). The instruction refers to them as , and so on, in the order they are sent. - Array of string - Examples: ["https://v3b.fal.media/files/b/0aaf2399/7tuRY3UT9tpKwYE1wX_SP_still-logo.png","https://v3b.fal.media/files/b/0aaf2399/T8kchxC_KKNEEkl-sK-Ge_still-perfume.png","https://v3b.fal.media/files/b/0aaf2399/9GKzb93bJ0SDaxAQlG0mr_still-background.png"] - **`instruction`** (`string`, _optional_): The edit, in free-form text. It is expanded into a VGL, which is returned. With 'vgl', the change to make to it. - **`aspect_ratio`** (`Enum`, _optional_): Output aspect ratio, at about one megapixel. Left unset, the output keeps the ratio of the first image. A single image always keeps its own ratio. - Options: `"1:1"`, `"1:2"`, `"1:3"`, `"1:4"`, `"1:5"`, `"2:1"`, `"2:3"`, `"3:1"`, `"3:2"`, `"3:4"`, `"4:1"`, `"4:3"`, `"4:5"`, `"5:1"`, `"5:4"`, `"9:16"`, `"9:21"`, `"10:16"`, `"16:9"`, `"16:10"`, `"21:9"` - **`seed`** (`integer`, _optional_): Random seed for reproducibility, 0 to 2147483647. Default value: `5555` - Default: `5555` - Range: `0` to `2147483647` - **`mask_url`** (`string`, _optional_): Mask (file or URL) marking the region to regenerate: white where the model should edit, black elsewhere. Single-image requests only, at that image's size. A masked edit comes back at the image's own size, with its own pixels outside the mask. - **`sync_mode`** (`boolean`, _optional_): If true, returns the image directly in the response (increases latency). - Default: `false` - **`vgl`** (`VglEdit`, _optional_): A VGL (Visual Generation Language) document. Alone, it is the edit as-is and must carry its 'edit_instruction'. With 'instruction', it is the first image's VGL, the baseline the edit is written from. Accepts what a previous request returned. - Examples: {"photographic_characteristics":{"focus":"Sharp focus on the perfume bottle and boulder","depth_of_field":"Shallow atmospheric depth","camera_angle":"Eye-level straight-on shot","lens_focal_length":"Standard portrait lens (e.g., 50mm-85mm)"},"artistic_style":"realistic","text_render":[{"location":"Upper sky, centered about 15-20% down from the top","text":"STILL","font":"Serif typeface with wide spacing","appearance_details":"Thin elegant capitals with subtle flared strokes, flat and crisp with no shadow","size":"Medium","color":"Muted warm charcoal grey"},{"location":"Upper sky, directly beneath the word STILL","text":"EAU DE PARFUM","font":"Serif typeface with wide spacing","appearance_details":"Matching small capitals with wide spacing, flat and crisp with no shadow","size":"Small","color":"Muted warm charcoal grey"}],"edit_instruction":"Create a luxury fragrance poster by placing the perfume bottle from upright on the grey boulder in the misty water from , and add the minimalist typography from in the upper sky.","context":"This is a conceptual luxury fragrance advertising campaign designed for a high-end magazine spread or billboard.","short_description":"A high-end luxury fragrance poster featuring the perfume bottle from centered atop the large grey boulder resting in calm water from , with the minimalist typography from floating in the misty sky above.","background_setting":"Perfectly calm, mirror-like water surface reflecting a dense, soft fog and low cloud sky with a warm peach-cream glow breaking through near the top.","lighting":{"shadows":"Soft contact shadows beneath the perfume bottle on the stone","direction":"Top-lit","conditions":"Soft diffused fog light with warm peach glow from above"},"style_medium":"photograph","objects":[{"location":"Center, on top of the boulder","number_of_objects":1,"appearance_details":"Soft diffused fog light wrapping the glass, gentle edge highlights, and a subtle warm glow in the liquid","description":"A square clear glass perfume flacon with thick beveled walls, crisp edges, filled with rose-gold liquid, featuring a thin internal dip tube, a short dark metal collar, and a wide matte black cap.","texture":"Smooth glass and matte metal","orientation":"Upright","relationship":"Resting upright on the flat top surface of the large grey boulder","shape_and_color":"Square prism, clear glass with rose-gold liquid and black cap","relative_size":"Medium within frame"},{"location":"Lower half of the frame","number_of_objects":1,"appearance_details":"Catches soft diffused light on its upper facets","description":"A single large grey boulder with a weathered, slightly rough stone surface sitting in calm water.","texture":"Rough, weathered stone","orientation":"Static","relationship":"Supporting the perfume bottle on its flat top surface and casting a complete reflection in the water below","shape_and_color":"Irregular block shape, grey stone","relative_size":"Large within frame"}],"aesthetics":{"mood_atmosphere":"Serene, minimalist, luxurious, and tranquil","composition":"Centered editorial composition with rule of thirds horizon","color_scheme":"Muted palette of fog grey, slate, blue-grey, and warm peach, accented by rose-gold"}} **Required Parameters Example**: ```json { "image_urls": [ "https://v3b.fal.media/files/b/0aaf2399/7tuRY3UT9tpKwYE1wX_SP_still-logo.png", "https://v3b.fal.media/files/b/0aaf2399/T8kchxC_KKNEEkl-sK-Ge_still-perfume.png", "https://v3b.fal.media/files/b/0aaf2399/9GKzb93bJ0SDaxAQlG0mr_still-background.png" ] } ``` **Full Example**: ```json { "image_urls": [ "https://v3b.fal.media/files/b/0aaf2399/7tuRY3UT9tpKwYE1wX_SP_still-logo.png", "https://v3b.fal.media/files/b/0aaf2399/T8kchxC_KKNEEkl-sK-Ge_still-perfume.png", "https://v3b.fal.media/files/b/0aaf2399/9GKzb93bJ0SDaxAQlG0mr_still-background.png" ], "seed": 5555, "vgl": { "photographic_characteristics": { "focus": "Sharp focus on the perfume bottle and boulder", "depth_of_field": "Shallow atmospheric depth", "camera_angle": "Eye-level straight-on shot", "lens_focal_length": "Standard portrait lens (e.g., 50mm-85mm)" }, "artistic_style": "realistic", "text_render": [ { "location": "Upper sky, centered about 15-20% down from the top", "text": "STILL", "font": "Serif typeface with wide spacing", "appearance_details": "Thin elegant capitals with subtle flared strokes, flat and crisp with no shadow", "size": "Medium", "color": "Muted warm charcoal grey" }, { "location": "Upper sky, directly beneath the word STILL", "text": "EAU DE PARFUM", "font": "Serif typeface with wide spacing", "appearance_details": "Matching small capitals with wide spacing, flat and crisp with no shadow", "size": "Small", "color": "Muted warm charcoal grey" } ], "edit_instruction": "Create a luxury fragrance poster by placing the perfume bottle from upright on the grey boulder in the misty water from , and add the minimalist typography from in the upper sky.", "context": "This is a conceptual luxury fragrance advertising campaign designed for a high-end magazine spread or billboard.", "short_description": "A high-end luxury fragrance poster featuring the perfume bottle from centered atop the large grey boulder resting in calm water from , with the minimalist typography from floating in the misty sky above.", "background_setting": "Perfectly calm, mirror-like water surface reflecting a dense, soft fog and low cloud sky with a warm peach-cream glow breaking through near the top.", "lighting": { "shadows": "Soft contact shadows beneath the perfume bottle on the stone", "direction": "Top-lit", "conditions": "Soft diffused fog light with warm peach glow from above" }, "style_medium": "photograph", "objects": [ { "location": "Center, on top of the boulder", "number_of_objects": 1, "appearance_details": "Soft diffused fog light wrapping the glass, gentle edge highlights, and a subtle warm glow in the liquid", "description": "A square clear glass perfume flacon with thick beveled walls, crisp edges, filled with rose-gold liquid, featuring a thin internal dip tube, a short dark metal collar, and a wide matte black cap.", "texture": "Smooth glass and matte metal", "orientation": "Upright", "relationship": "Resting upright on the flat top surface of the large grey boulder", "shape_and_color": "Square prism, clear glass with rose-gold liquid and black cap", "relative_size": "Medium within frame" }, { "location": "Lower half of the frame", "number_of_objects": 1, "appearance_details": "Catches soft diffused light on its upper facets", "description": "A single large grey boulder with a weathered, slightly rough stone surface sitting in calm water.", "texture": "Rough, weathered stone", "orientation": "Static", "relationship": "Supporting the perfume bottle on its flat top surface and casting a complete reflection in the water below", "shape_and_color": "Irregular block shape, grey stone", "relative_size": "Large within frame" } ], "aesthetics": { "mood_atmosphere": "Serene, minimalist, luxurious, and tranquil", "composition": "Centered editorial composition with rule of thirds horizon", "color_scheme": "Muted palette of fog grey, slate, blue-grey, and warm peach, accented by rose-gold" } } } ``` ### Output Schema The API returns the following output format: - **`image`** (`Image`, _required_): The edited image. - **`images`** (`list`, _optional_): Single-element list holding the same image, as the sibling FIBO apps return. - Default: `[]` - Array of Image - Examples: [{"url":"https://v3b.fal.media/files/b/0aaf2399/wwPQolDDS5akCE74fOgzt_fibo-2-edit-example.png"}] - **`vgl`** (`Vgl`, _required_): The VGL the edit ran, including its 'edit_instruction'. - Examples: {"photographic_characteristics":{"focus":"Sharp focus on the perfume bottle and boulder","depth_of_field":"Shallow atmospheric depth","camera_angle":"Eye-level straight-on shot","lens_focal_length":"Standard portrait lens (e.g., 50mm-85mm)"},"artistic_style":"realistic","text_render":[{"location":"Upper sky, centered about 15-20% down from the top","text":"STILL","font":"Serif typeface with wide spacing","appearance_details":"Thin elegant capitals with subtle flared strokes, flat and crisp with no shadow","size":"Medium","color":"Muted warm charcoal grey"},{"location":"Upper sky, directly beneath the word STILL","text":"EAU DE PARFUM","font":"Serif typeface with wide spacing","appearance_details":"Matching small capitals with wide spacing, flat and crisp with no shadow","size":"Small","color":"Muted warm charcoal grey"}],"edit_instruction":"Create a luxury fragrance poster by placing the perfume bottle from upright on the grey boulder in the misty water from , and add the minimalist typography from in the upper sky.","context":"This is a conceptual luxury fragrance advertising campaign designed for a high-end magazine spread or billboard.","short_description":"A high-end luxury fragrance poster featuring the perfume bottle from centered atop the large grey boulder resting in calm water from , with the minimalist typography from floating in the misty sky above.","background_setting":"Perfectly calm, mirror-like water surface reflecting a dense, soft fog and low cloud sky with a warm peach-cream glow breaking through near the top.","lighting":{"shadows":"Soft contact shadows beneath the perfume bottle on the stone","direction":"Top-lit","conditions":"Soft diffused fog light with warm peach glow from above"},"style_medium":"photograph","objects":[{"location":"Center, on top of the boulder","number_of_objects":1,"appearance_details":"Soft diffused fog light wrapping the glass, gentle edge highlights, and a subtle warm glow in the liquid","description":"A square clear glass perfume flacon with thick beveled walls, crisp edges, filled with rose-gold liquid, featuring a thin internal dip tube, a short dark metal collar, and a wide matte black cap.","texture":"Smooth glass and matte metal","orientation":"Upright","relationship":"Resting upright on the flat top surface of the large grey boulder","shape_and_color":"Square prism, clear glass with rose-gold liquid and black cap","relative_size":"Medium within frame"},{"location":"Lower half of the frame","number_of_objects":1,"appearance_details":"Catches soft diffused light on its upper facets","description":"A single large grey boulder with a weathered, slightly rough stone surface sitting in calm water.","texture":"Rough, weathered stone","orientation":"Static","relationship":"Supporting the perfume bottle on its flat top surface and casting a complete reflection in the water below","shape_and_color":"Irregular block shape, grey stone","relative_size":"Large within frame"}],"aesthetics":{"mood_atmosphere":"Serene, minimalist, luxurious, and tranquil","composition":"Centered editorial composition with rule of thirds horizon","color_scheme":"Muted palette of fog grey, slate, blue-grey, and warm peach, accented by rose-gold"}} **Example Response**: ```json { "image": { "url": "", "content_type": "image/png", "file_name": "z9RV14K95DvU.png", "file_size": 4404019, "width": 1024, "height": 1024 }, "images": [ { "url": "https://v3b.fal.media/files/b/0aaf2399/wwPQolDDS5akCE74fOgzt_fibo-2-edit-example.png" } ], "vgl": { "photographic_characteristics": { "focus": "Sharp focus on the perfume bottle and boulder", "depth_of_field": "Shallow atmospheric depth", "camera_angle": "Eye-level straight-on shot", "lens_focal_length": "Standard portrait lens (e.g., 50mm-85mm)" }, "artistic_style": "realistic", "text_render": [ { "location": "Upper sky, centered about 15-20% down from the top", "text": "STILL", "font": "Serif typeface with wide spacing", "appearance_details": "Thin elegant capitals with subtle flared strokes, flat and crisp with no shadow", "size": "Medium", "color": "Muted warm charcoal grey" }, { "location": "Upper sky, directly beneath the word STILL", "text": "EAU DE PARFUM", "font": "Serif typeface with wide spacing", "appearance_details": "Matching small capitals with wide spacing, flat and crisp with no shadow", "size": "Small", "color": "Muted warm charcoal grey" } ], "edit_instruction": "Create a luxury fragrance poster by placing the perfume bottle from upright on the grey boulder in the misty water from , and add the minimalist typography from in the upper sky.", "context": "This is a conceptual luxury fragrance advertising campaign designed for a high-end magazine spread or billboard.", "short_description": "A high-end luxury fragrance poster featuring the perfume bottle from centered atop the large grey boulder resting in calm water from , with the minimalist typography from floating in the misty sky above.", "background_setting": "Perfectly calm, mirror-like water surface reflecting a dense, soft fog and low cloud sky with a warm peach-cream glow breaking through near the top.", "lighting": { "shadows": "Soft contact shadows beneath the perfume bottle on the stone", "direction": "Top-lit", "conditions": "Soft diffused fog light with warm peach glow from above" }, "style_medium": "photograph", "objects": [ { "location": "Center, on top of the boulder", "number_of_objects": 1, "appearance_details": "Soft diffused fog light wrapping the glass, gentle edge highlights, and a subtle warm glow in the liquid", "description": "A square clear glass perfume flacon with thick beveled walls, crisp edges, filled with rose-gold liquid, featuring a thin internal dip tube, a short dark metal collar, and a wide matte black cap.", "texture": "Smooth glass and matte metal", "orientation": "Upright", "relationship": "Resting upright on the flat top surface of the large grey boulder", "shape_and_color": "Square prism, clear glass with rose-gold liquid and black cap", "relative_size": "Medium within frame" }, { "location": "Lower half of the frame", "number_of_objects": 1, "appearance_details": "Catches soft diffused light on its upper facets", "description": "A single large grey boulder with a weathered, slightly rough stone surface sitting in calm water.", "texture": "Rough, weathered stone", "orientation": "Static", "relationship": "Supporting the perfume bottle on its flat top surface and casting a complete reflection in the water below", "shape_and_color": "Irregular block shape, grey stone", "relative_size": "Large within frame" } ], "aesthetics": { "mood_atmosphere": "Serene, minimalist, luxurious, and tranquil", "composition": "Centered editorial composition with rule of thirds horizon", "color_scheme": "Muted palette of fog grey, slate, blue-grey, and warm peach, accented by rose-gold" } } } ``` ## Usage Examples ### cURL ```bash curl --request POST \ --url https://fal.run/bria/fibo-2/edit \ --header "Authorization: Key $FAL_KEY" \ --header "Content-Type: application/json" \ --data '{ "image_urls": [ "https://v3b.fal.media/files/b/0aaf2399/7tuRY3UT9tpKwYE1wX_SP_still-logo.png", "https://v3b.fal.media/files/b/0aaf2399/T8kchxC_KKNEEkl-sK-Ge_still-perfume.png", "https://v3b.fal.media/files/b/0aaf2399/9GKzb93bJ0SDaxAQlG0mr_still-background.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( "bria/fibo-2/edit", arguments={ "image_urls": ["https://v3b.fal.media/files/b/0aaf2399/7tuRY3UT9tpKwYE1wX_SP_still-logo.png", "https://v3b.fal.media/files/b/0aaf2399/T8kchxC_KKNEEkl-sK-Ge_still-perfume.png", "https://v3b.fal.media/files/b/0aaf2399/9GKzb93bJ0SDaxAQlG0mr_still-background.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("bria/fibo-2/edit", { input: { image_urls: ["https://v3b.fal.media/files/b/0aaf2399/7tuRY3UT9tpKwYE1wX_SP_still-logo.png", "https://v3b.fal.media/files/b/0aaf2399/T8kchxC_KKNEEkl-sK-Ge_still-perfume.png", "https://v3b.fal.media/files/b/0aaf2399/9GKzb93bJ0SDaxAQlG0mr_still-background.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/bria/fibo-2/edit) - [API Documentation](https://fal.ai/models/bria/fibo-2/edit/api) - [OpenAPI Schema](https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=bria/fibo-2/edit) ### fal.ai Platform - [Platform Documentation](https://fal.ai/docs/documentation) - [Python Client](https://fal.ai/docs/api-reference/client-libraries/python) - [JavaScript Client](https://fal.ai/docs/api-reference/client-libraries/javascript) ### Other agent-readable surfaces This file covers one model. To find anything else: - [Platform overview](https://fal.ai/llms.txt): Entry points and representative endpoint IDs - [Documentation index](https://fal.ai/docs/llms.txt): Every documentation page - [Full documentation text](https://fal.ai/docs/llms-full.txt): The whole documentation inlined - Any other model: `https://fal.ai/models//llms.txt`