# Bria Fibo Edit 1.5 image editing

Takes image urls, mask url, instruction and more, all optional. Served by fal.ai.

Fibo Edit 1.5 Image Editing, served by fal.ai. The OpenAPI schema for the bria/fibo-edit-1.5/edit queue. Price: $0.04 per images Queued execution; final USD charge comes from the unique billing event matching this exact endpoint and request_id. A missing receipt retains the reservation; no guessed final fee. Asynchronous: returns a request_id; poll fal/status and fetch fal/result with model "bria/fibo-edit-1.5" and that request_id. Billed once, when the result is ready; a generation that fails is refunded.

- Tool ID: `fal/bria-fibo-edit-1-5-edit`
- Name in the catalog: Fibo Edit 1.5 Image Editing
- Provider: [fal.ai](/providers/fal.md)
- Capability: [AI image generation](/tools/image-generation.md)
- Price: $0.04 per call
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

The provider’s price, with no markup. Billed for measured usage.


```json
{
  "model": "per_call",
  "amountUsd": 0.04
}
```

Pricing source: [https://fal.ai/models/bria/fibo-edit-1.5/edit](https://fal.ai/models/bria/fibo-edit-1.5/edit). $0.04 per images Queued execution; final USD charge comes from the unique billing event matching this exact endpoint and request_id. A missing receipt retains the reservation; no guessed final fee..

Price verification date: 2026-10-07.

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "image_urls": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ],
      "description": "1-4 reference images (files or URLs). Order is significant: the instruction is resolved against the images in the order they are sent.",
      "title": "Image Urls"
    },
    "mask_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Mask (file or URL) marking the region to regenerate: white where the model should edit, black elsewhere. Single-reference requests only, and it must be the same size as that image. A masked edit comes back at the reference's own resolution.",
      "title": "Mask Url"
    },
    "instruction": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Instruction for image editing.",
      "title": "Instruction"
    },
    "structured_instruction": {
      "anyOf": [
        {
          "properties": {
            "context": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "The context of the image to be generated.",
              "title": "Context"
            },
            "lighting": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "conditions": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The conditions of the lighting in the image to be generated.",
                      "title": "Conditions"
                    },
                    "shadows": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The shadows in the image to be generated.",
                      "title": "Shadows"
                    },
                    "direction": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The direction of the lighting in the image to be generated.",
                      "title": "Direction"
                    }
                  },
                  "x-fal-order-properties": [
                    "conditions",
                    "direction",
                    "shadows"
                  ],
                  "title": "Lighting"
                },
                {
                  "type": "null"
                }
              ],
              "description": "The lighting of the image to be generated."
            },
            "edit_instruction": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "The edit instruction for the image.",
              "title": "Edit Instruction"
            },
            "style_medium": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "The style medium of the image to be generated.",
              "title": "Style Medium"
            },
            "aesthetics": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "mood_atmosphere": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The mood and atmosphere of the image to be generated.",
                      "title": "Mood Atmosphere"
                    },
                    "composition": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The composition of the image to be generated.",
                      "title": "Composition"
                    },
                    "preference_score": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The preference score of the image to be generated.",
                      "title": "Preference Score"
                    },
                    "color_scheme": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The color scheme of the image to be generated.",
                      "title": "Color Scheme"
                    },
                    "aesthetic_score": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The aesthetic score of the image to be generated.",
                      "title": "Aesthetic Score"
                    }
                  },
                  "x-fal-order-properties": [
                    "composition",
                    "color_scheme",
                    "mood_atmosphere",
                    "aesthetic_score",
                    "preference_score"
                  ],
                  "title": "Aesthetics"
                },
                {
                  "type": "null"
                }
              ],
              "description": "The aesthetics of the image to be generated."
            },
            "photographic_characteristics": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "camera_angle": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The angle of the camera in the image to be generated.",
                      "title": "Camera Angle"
                    },
                    "depth_of_field": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The depth of field in the image to be generated.",
                      "title": "Depth Of Field"
                    },
                    "focus": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The focus in the image to be generated.",
                      "title": "Focus"
                    },
                    "lens_focal_length": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The focal length of the lens in the image to be generated.",
                      "title": "Lens Focal Length"
                    }
                  },
                  "x-fal-order-properties": [
                    "depth_of_field",
                    "focus",
                    "camera_angle",
                    "lens_focal_length"
                  ],
                  "title": "PhotographicCharacteristics"
                },
                {
                  "type": "null"
                }
              ],
              "description": "The photographic characteristics of the image to be generated."
            },
            "text_render": {
              "anyOf": [
                {
                  "type": "array",
                  "items": {}
                },
                {
                  "type": "null"
                }
              ],
              "default": [],
              "description": "A list of text to be rendered in the image.",
              "title": "Text Render"
            },
            "background_setting": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "The background setting of the image to be generated.",
              "title": "Background Setting"
            },
            "short_description": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "A short description of the image to be generated.",
              "title": "Short Description"
            },
            "objects": {
              "anyOf": [
                {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "gender": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The gender of the object in the image.",
                        "title": "Gender"
                      },
                      "texture": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The texture of the object.",
                        "title": "Texture"
                      },
                      "clothing": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The clothing of the object in the image.",
                        "title": "Clothing"
                      },
                      "number_of_objects": {
                        "anyOf": [
                          {
                            "type": "integer"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The number of objects in the image.",
                        "title": "Number Of Objects"
                      },
                      "relative_size": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The relative size of the object in the image.",
                        "title": "Relative Size"
                      },
                      "skin_tone_and_texture": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The skin tone and texture of the object in the image.",
                        "title": "Skin Tone And Texture"
                      },
                      "shape_and_color": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The shape and color of the object.",
                        "title": "Shape And Color"
                      },
                      "expression": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The expression of the object in the image.",
                        "title": "Expression"
                      },
                      "relationship": {
                        "type": "string",
                        "description": "The relationship of the object to other objects in the image.",
                        "title": "Relationship"
                      },
                      "description": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "A description of the object to be generated.",
                        "title": "Description"
                      },
                      "orientation": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The orientation of the object in the image.",
                        "title": "Orientation"
                      },
                      "action": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The action of the object in the image.",
                        "title": "Action"
                      },
                      "location": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The location of the object in the image.",
                        "title": "Location"
                      },
                      "pose": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The pose of the object in the image.",
                        "title": "Pose"
                      },
                      "appearance_details": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The appearance details of the object.",
                        "title": "Appearance Details"
                      }
                    },
                    "x-fal-order-properties": [
                      "description",
                      "location",
                      "relationship",
                      "relative_size",
                      "shape_and_color",
                      "texture",
                      "appearance_details",
                      "number_of_objects",
                      "pose",
                      "expression",
                      "clothing",
                      "action",
                      "gender",
                      "skin_tone_and_texture",
                      "orientation"
                    ],
                    "required": [
                      "relationship"
                    ],
                    "title": "PromptObject"
                  }
                },
                {
                  "type": "null"
                }
              ],
              "default": [],
              "description": "A list of objects in the image to be generated, along with their attributes and relationships to other objects in the image.",
              "title": "Objects"
            },
            "artistic_style": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "The artistic style of the image to be generated.",
              "title": "Artistic Style"
            }
          },
          "additionalProperties": true,
          "type": "object",
          "x-fal-order-properties": [
            "short_description",
            "objects",
            "background_setting",
            "lighting",
            "aesthetics",
            "photographic_characteristics",
            "style_medium",
            "text_render",
            "context",
            "artistic_style",
            "edit_instruction"
          ],
          "title": "StructuredInstruction"
        },
        {
          "type": "null"
        }
      ],
      "description": "A pre-built structured prompt, used verbatim instead of having VGL build one when no instruction is sent. Accepts what a previous edit returned."
    },
    "aspect_ratio": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "1:1",
            "2:3",
            "3:2",
            "3:4",
            "4:3",
            "4:5",
            "5:4",
            "9:16",
            "16:9"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "Output aspect ratio. Left unset, the output keeps the ratio of the first reference image. A chosen ratio applies only with two or more reference images; with a single reference the output keeps that image's ratio either way.",
      "title": "Aspect Ratio"
    },
    "seed": {
      "type": "integer",
      "default": 5555,
      "description": "Random seed for reproducibility.",
      "title": "Seed"
    }
  },
  "additionalProperties": false
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "fal/bria-fibo-edit-1-5-edit",
  "input": {
    "image_urls": [
      "https://v3b.fal.media/files/b/0aa69153/6d2UFjgrQCRM6BoWpXpZ3_126_1.jpg",
      "https://v3b.fal.media/files/b/0aa69153/Gy-fjFofCbQP9w3lsfc2e_126_2.jpg"
    ],
    "instruction": "Uncross her arms and place the serum bottle in her right hand raised beside her face, label toward the camera.",
    "seed": 5555
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

This tool uses deferred settlement. Follow its returned task/run instructions; preserve the existing reservation until the result is reconciled.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://fal.ai/models/bria/fibo-edit-1.5/edit)

[REST inspection](https://api.agentik.cc/v1/tools/fal/bria-fibo-edit-1-5-edit) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/fal/bria-fibo-edit-1-5-edit) · [Agent index](/llms.txt)
