GET

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

kind inputactivity imagehash e359b34b…extracted Oct 21, 2026version currentsource upstream spec ↗
fieldrecorded source
schemaSource linked above.

upstream-spec

Source trace
84396e6ee911e839d672dc446267a65e2d59c3e9f730a7fccaffb65407bf77ce
{
  "fetchedAt": 1792558810,
  "extractorVersion": "1",
  "verifiedAt": null
}

Request body

7 properties · 0 required · 6 $defs
propertytypedescriptionconstraints
styleenumA style for the generated image. Requires 'prompt'; not with 'image_url', 'vgl' or 'negative_prompt'.Kodak Film | Hard Flash | Hazy Dreamy | Rough Realism · nullable
seedintegerRandom seed for reproducibility, 0 to 2147483647.0 ≤ n ≤ 2147483647 · default: 5555
image_urlstringA reference image (inspire mode). With 'prompt', VGL uses it as a visual reference for the prompt's scene and generates a new image of that scene, not the image. Alone, the VGL describes the image itself, so the result is a close variation of it. Not with 'vgl'.nullable
vglVglA VGL (Visual Generation Language) document: the structured JSON description of the scene. Alone, the model renders it as-is. With 'prompt', VGL changes it by the prompt (refine) and the result is rendered. Accepts what a previous request returned. Not with 'image_url' or 'style'.nullable
aspect_ratioenumAspect ratio of the image, at about one megapixel. 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:91:1 | 1:2 | 1:3 | 1:4 | 1:5 | 2:1 · +15 more · default: "1:1"
promptstringWhat to generate, in free-form text. It is expanded into a VGL, which is returned. With 'vgl', the change to make to it.nullable
sync_modebooleanIf true, returns the image directly in the response (increases latency).default: false

Types

6 $defs

Aestheticsobject

mood_atmospherestringThe mood and atmosphere of the image to be generated.nullable
compositionstringThe composition of the image to be generated.nullable
color_schemestringThe color scheme of the image to be generated.nullable

Lightingobject

shadowsstringThe shadows in the image to be generated.nullable
directionstringThe direction of the lighting in the image to be generated.nullable
conditionsstringThe conditions of the lighting in the image to be generated.nullable

PhotographicCharacteristicsobject

focusstringThe focus in the image to be generated.nullable
depth_of_fieldstringThe depth of field in the image to be generated.nullable
camera_anglestringThe angle of the camera in the image to be generated.nullable
lens_focal_lengthstringThe focal length of the lens in the image to be generated.nullable

PromptObjectobject

locationstringThe location of the object in the image.nullable
number_of_objectsintegerThe number of objects in the image.nullable
descriptionstringA description of the object to be generated.nullable
posestringThe pose of the object in the image.nullable
skin_tone_and_texturestringThe skin tone and texture of the object in the image.nullable
actionstringThe action of the object in the image.nullable
genderstringThe gender of the object in the image.nullable
shape_and_colorstringThe shape and color of the object.nullable
relative_sizestringThe relative size of the object in the image.nullable
appearance_detailsstringThe appearance details of the object.nullable
texturestringThe texture of the object.nullable
orientationstringThe orientation of the object in the image.nullable
clothingstringThe clothing of the object in the image.nullable
expressionstringThe expression of the object in the image.nullable
relationship*stringThe relationship of the object to other objects in the image.

TextRenderobject

locationstringWhere the text sits in the image.nullable
text*stringThe text to render. fibo-2 is also shown an image of it, so it renders as written.
fontstringThe style of the font.nullable
appearance_detailsstringAny other notable visual details of the text.nullable
sizestringThe size of the text in the image.nullable
colorstringThe color of the text.nullable

Vglobject

photographic_characteristicsPhotographicCharacteristicsThe photographic characteristics of the image to be generated.nullable
artistic_stylestringThe artistic style of the image to be generated.nullable
background_settingstringThe background setting of the image to be generated.nullable
objectsPromptObject[]A list of objects in the image to be generated, along with their attributes and relationships to other objects in the image.nullable
contextstringThe context of the image to be generated.nullable
short_descriptionstringA short description of the image to be generated.nullable
text_renderTextRender[]A list of text to be rendered in the image.nullable
lightingLightingThe lighting of the image to be generated.nullable
style_mediumstringThe style medium of the image to be generated.nullable
aestheticsAestheticsThe aesthetics 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/generate","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}