GET
/v1/schemas/fal/image/bria/fibo-2/generate
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace84396e6ee911e839d672dc446267a65e2d59c3e9f730a7fccaffb65407bf77ce{
"fetchedAt": 1792558810,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
7 properties · 0 required · 6 $defs| property | type | description | constraints |
|---|---|---|---|
| style | enum | A style for the generated image. Requires 'prompt'; not with 'image_url', 'vgl' or 'negative_prompt'. | Kodak Film | Hard Flash | Hazy Dreamy | Rough Realism · nullable |
| seed | integer | Random seed for reproducibility, 0 to 2147483647. | 0 ≤ n ≤ 2147483647 · default: 5555 |
| image_url | string | A 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 |
| vgl | Vgl | A 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_ratio | enum | Aspect 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:9 | 1:1 | 1:2 | 1:3 | 1:4 | 1:5 | 2:1 · +15 more · default: "1:1" |
| prompt | string | What 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_mode | boolean | If true, returns the image directly in the response (increases latency). | default: false |
Types
6 $defsAestheticsobject
| mood_atmosphere | string | The mood and atmosphere of the image to be generated. | nullable |
| composition | string | The composition of the image to be generated. | nullable |
| color_scheme | string | The color scheme of the image to be generated. | nullable |
Lightingobject
| shadows | string | The shadows in the image to be generated. | nullable |
| direction | string | The direction of the lighting in the image to be generated. | nullable |
| conditions | string | The conditions of the lighting in the image to be generated. | nullable |
PhotographicCharacteristicsobject
| focus | string | The focus in the image to be generated. | nullable |
| 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 |
| lens_focal_length | string | The focal length of the lens in the image to be generated. | nullable |
PromptObjectobject
| location | string | The location of the object in the image. | nullable |
| number_of_objects | integer | The number of objects in the image. | nullable |
| description | string | A description of the object to be generated. | nullable |
| pose | string | The pose of the object in the image. | nullable |
| skin_tone_and_texture | string | The skin tone and texture of the object in the image. | nullable |
| action | string | The action of the object in the image. | nullable |
| gender | string | The gender of the object in the image. | nullable |
| shape_and_color | string | The shape and color of the object. | nullable |
| relative_size | string | The relative size of the object in the image. | nullable |
| appearance_details | string | The appearance details of the object. | nullable |
| texture | string | The texture of the object. | nullable |
| orientation | string | The orientation of the object in the image. | nullable |
| clothing | string | The clothing of the object in the image. | nullable |
| expression | string | The expression of the object in the image. | nullable |
| relationship* | string | The relationship of the object to other objects in the image. |
TextRenderobject
| location | string | Where the text sits in the image. | nullable |
| text* | string | The text to render. fibo-2 is also shown an image of it, so it renders as written. | |
| font | string | The style of the font. | nullable |
| appearance_details | string | Any other notable visual details of the text. | nullable |
| size | string | The size of the text in the image. | nullable |
| color | string | The color of the text. | nullable |
Vglobject
| photographic_characteristics | PhotographicCharacteristics | The photographic characteristics of the image to be generated. | nullable |
| artistic_style | string | The artistic style 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 |
| context | string | The context of the image to be generated. | nullable |
| short_description | string | A short description of the image to be generated. | nullable |
| text_render | TextRender[] | A list of text to be rendered in the image. | nullable |
| lighting | Lighting | The lighting of the image to be generated. | nullable |
| style_medium | string | The style medium of the image to be generated. | nullable |
| aesthetics | Aesthetics | The aesthetics of the image to be generated. | nullable |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"bria/fibo-2/generate","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}