GET

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

kind inputactivity imagehash cc932180…extracted Nov 18, 2026version currentsource upstream spec ↗
fieldrecorded source
schemaSource linked above.

upstream-spec

Source trace
8642992638a8ff6f47ba6c674bd6496b349a46b1b40f0974d9e4c0f5e23b7c4b
{
  "fetchedAt": 1794978001,
  "extractorVersion": "2",
  "verifiedAt": null
}

Request body

8 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
resolutionenumSize of the image. 1K (the default): about one megapixel, 1024x1024 at 1:1 (1408x792 at 16:9). 2K: about four megapixels, the 1K image re-rendered at twice its width and height with finer detail, 2048x2048 at 1:1 (2816x1584 at 16:9). The extra pass takes about…1K | 2K
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
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
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"
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
color_schemestringThe color scheme of the image to be generated.nullable
compositionstringThe composition of the image to be generated.nullable

Lightingobject

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

PhotographicCharacteristicsobject

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

PromptObjectobject

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

TextRenderobject

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

Vglobject

short_descriptionstringA short description of the image to be generated.nullable
lightingLightingThe lighting of the image to be generated.nullable
aestheticsAestheticsThe aesthetics of the image to be generated.nullable
style_mediumstringThe style medium 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
text_renderTextRender[]A list of text to be rendered in the image.nullable
background_settingstringThe background setting of the image to be generated.nullable
photographic_characteristicsPhotographicCharacteristicsThe photographic characteristics of the image to be generated.nullable
contextstringThe context of the image to be generated.nullable
artistic_stylestringThe artistic style 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", …}]}