GET

/v1/schemas/fal/image/bria/fibo-2/edit

Accept:

kind inputactivity imagehash 7093e6ce…extracted Oct 23, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. upstream-spec Source trace `af40e85d915f4727d3fd430c816a969b83589d67773cd63f34be7b015abc7927` { "fetchedAt": 1792731610, "extractorVersion": "1", "verifiedAt": null }

Request body

7 properties · 1 required · 6 $defs

property	type	description	constraints
image_urls*	string[]	1-4 images to edit (files or URLs). The instruction refers to them as <image_1>, <image_2> and so on, in the order they are sent.	items ≥ 1 · items ≤ 4
instruction	string	The edit, in free-form text. It is expanded into a VGL, which is returned. With 'vgl', the change to make to it. 'prompt' is accepted as an alias.	nullable
vgl	VglEdit	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.	nullable
sync_mode	boolean	If true, returns the image directly in the response (increases latency).	default: false
seed	integer	Random seed for reproducibility, 0 to 2147483647.	0 ≤ n ≤ 2147483647 · default: 5555
aspect_ratio	enum	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.	1:1 \| 1:2 \| 1:3 \| 1:4 \| 1:5 \| 2:1 · +15 more · nullable
mask_url	string	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.	nullable

Types

6 $defs

Aestheticsobject

composition	string	The composition of the image to be generated.	nullable
mood_atmosphere	string	The mood and atmosphere of the image to be generated.	nullable
color_scheme	string	The color scheme of the image to be generated.	nullable

Lightingobject

direction	string	The direction of the lighting in the image to be generated.	nullable
shadows	string	The shadows in the image to be generated.	nullable
conditions	string	The conditions of the lighting in the image to be generated.	nullable

PhotographicCharacteristicsobject

depth_of_field	string	The depth of field in the image to be generated.	nullable
camera_angle	string	The angle of the camera in the image to be generated.	nullable
focus	string	The focus in the image to be generated.	nullable
lens_focal_length	string	The focal length of the lens in the image to be generated.	nullable

PromptObjectobject

number_of_objects	integer	The number of objects in the image.	nullable
clothing	string	The clothing of the object in the image.	nullable
location	string	The location of the object in the image.	nullable
texture	string	The texture of the object.	nullable
gender	string	The gender of the object in the image.	nullable
action	string	The action of the object in the image.	nullable
pose	string	The pose of the object in the image.	nullable
relative_size	string	The relative size of the object in the image.	nullable
description	string	A description of the object to be generated.	nullable
orientation	string	The orientation of the object in the image.	nullable
relationship*	string	The relationship of the object to other objects in the image.
shape_and_color	string	The shape and color of the object.	nullable
appearance_details	string	The appearance details of the object.	nullable
expression	string	The expression of the object in the image.	nullable
skin_tone_and_texture	string	The skin tone and texture of the object in the image.	nullable

TextRenderobject

location	string	Where the text sits in the image.	nullable
appearance_details	string	Any other notable visual details of the text.	nullable
color	string	The color of the text.	nullable
text*	string	The text to render. fibo-2 is also shown an image of it, so it renders as written.
size	string	The size of the text in the image.	nullable
font	string	The style of the font.	nullable

VglEditobject

aesthetics	Aesthetics	The aesthetics of the image to be generated.	nullable
background_setting	string	The background setting of the image to be generated.	nullable
objects	PromptObject[]	A list of objects in the image to be generated, along with their attributes and relationships to other objects in the image.	nullable
text_render	TextRender[]	A list of text to be rendered in the image.	nullable
photographic_characteristics	PhotographicCharacteristics	The photographic characteristics of the image to be generated.	nullable
edit_instruction	string	The edit instruction for the image.	nullable
context	string	The context of the image to be generated.	nullable
artistic_style	string	The artistic style of the image to be generated.	nullable
style_medium	string	The style medium of the image to be generated.	nullable
lighting	Lighting	The lighting of the image to be generated.	nullable
short_description	string	A short description of the image to be generated.	nullable

Validate a payload

before you spend tokens

shell

$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"bria/fibo-2/edit","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}