GET

/v1/schemas/fal/image/bria/fibo-bbq-preview/generate

Accept:

kind inputactivity imagehash 4b595c8b…extracted Jul 6, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. Source trace `8ff800798c7c4e1572bfdef51bef48122b0c39264f24e39731b22a8083388d04` { "fetchedAt": 1783331098, "extractorVersion": "1", "verifiedAt": null }

Request body

9 properties · 0 required · 8 $defs

property	type	description	constraints
prompt	string	Prompt for image generation.	nullable
steps_num	integer	Number of inference steps.	20 ≤ n ≤ 50 · default: 50
aspect_ratio	enum	Aspect ratio. Options: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9	1:1 \| 2:3 \| 3:2 \| 3:4 \| 4:3 \| 4:5 · +3 more · default: "1:1"
image_url	string	Reference image (file or URL).	nullable
sync_mode	boolean	If true, returns the image directly in the response (increases latency).	default: false
guidance_scale	integer	Guidance scale for text.	3 ≤ n ≤ 5 · default: 5
seed	integer	Random seed for reproducibility.	default: 5555
negative_prompt	string	Negative prompt for image generation.	default: ""
structured_prompt	StructuredPrompt \| string \| object	The structured prompt to generate an image from.	nullable

Types

8 $defs

Aestheticsobject

preference_score	string	The preference score of the image (e.g., 'very high', 'high', 'medium', 'low').	nullable
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
aesthetic_score	string	The aesthetic score of the image (e.g., 'very high', 'high', 'medium', 'low').	nullable
color_scheme	string	The color scheme of the image to be generated.	nullable

BoundingBoxobject

bottom_right*	Point	The bottom-right corner of the bounding box.
top_left*	Point	The top-left corner of the bounding box.

Colorobject

blue*	integer	The blue component of the color (0-255).
green*	integer	The green component of the color (0-255).
red*	integer	The red component of the color (0-255).
name	string	The name of the color.	nullable

Lightingobject

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
direction	string	The direction of the lighting in the image to be generated.	nullable

PhotographicCharacteristicsobject

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
camera_angle	string	The angle of the camera in the image to be generated.	nullable
depth_of_field	string	The depth of field in the image to be generated.	nullable

Pointobject

y*	number	The y coordinate.
x*	number	The x coordinate.

PromptObjectobject

skin_color	Color	The RGB color values for the skin tone of the object.	nullable
description	string	A description of the object to be generated.	nullable
clothing	string	The clothing of the object in the image.	nullable
orientation	string	The orientation of the object in the image.	nullable
colors	Color[]	A list of colors associated with the object.	nullable
skin_tone_and_texture	string	The skin tone and texture of the object in the image.	nullable
appearance_details	string	The appearance details of the object.	nullable
number_of_objects	integer	The number of objects in the image.	nullable
relative_distance	number	The relative distance of the object from the camera or viewer.	nullable
expression	string	The expression of the object in the image.	nullable
pose	string	The pose of the object in the image.	nullable
shape_and_color	string	The shape and color of the object.	nullable
relationship	string	The relationship of the object to other objects in the image.	nullable
texture	string	The texture of the object.	nullable
gender	string	The gender of the object in the image.	nullable
relative_size	string	The relative size of the object in the image.	nullable
location	string	The location of the object in the image.	nullable
bounding_boxes	BoundingBox[]	Bounding boxes defining the location of the object in the image.	nullable
action	string	The action of the object in the image.	nullable

StructuredPromptobject

background_setting	string	The background setting 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
text_render	any[]	A list of text to be rendered in the image.	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
aesthetics	Aesthetics	The aesthetics of the image to be generated.	nullable
photographic_characteristics	PhotographicCharacteristics	The photographic characteristics of the image to be generated.	nullable
context	string	The context of the image to be generated.	nullable
lighting	Lighting	The lighting of the image to be generated.	nullable
color_palette	Color[]	A list of colors that define the overall color palette of the image.	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-bbq-preview/generate","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}