GET
/v1/schemas/fal/image/blackforestlabs%2Fflux-3%2Fklein%2Fedit-image
Accept:
Request body
10 properties · 2 required · 3 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | A complete caption of the target image with the edit folded in. Refer to the references by their order: the first image, the second image. | |
| image_urls* | string[] | The reference images to edit or compose from (up to 10). | items ≥ 1 · items ≤ 10 |
| image_size | ImageSize | enum | The size of the generated image, 256 to 4096 pixels per side. If not set, a single reference image's own size (scaled to at most 4 megapixels) is used, or the first reference image's size (at most 1 megapixel) when several are given. | nullable |
| seed | integer | The same seed and the same prompt given to the same version of the model will output the same image every time. | nullable |
| sync_mode | boolean | If `True`, the media will be returned as a data URI and the output data won't be available in the request history. | default: false |
| bounding_boxes | EditBoundingBox[] | Optional layout, with (0, 0) at the top-left of each image: keep, move, resize or remove objects from the references, or place new ones. Name boxes in the prompt by label, e.g. `<dragon>`. | items ≤ 32 · nullable |
| num_images | integer | The number of images to generate. | 1 ≤ n ≤ 4 · default: 1 |
| output_format | enum | The format of the generated image. | jpeg | png | webp · default: "png" |
| enable_prompt_expansion | boolean | If set to true, the prompt is expanded into a detailed caption (grounded in the reference images when editing) before generation. | default: true |
| enable_safety_checker | boolean | If set to true, the safety checker will be enabled. | default: true |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"blackforestlabs/flux-3/klein/edit-image","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}