GET
/v1/schemas/fal/image/blackforestlabs/flux-3/edit-image
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace2de719a4b5239c5777d09d13c207a1961a13c05e5c756c54be58bf36fbbaaf2b{
"fetchedAt": 1792731610,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
9 properties · 2 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | The prompt to generate an image from. | |
| image_urls* | string[] | Reference image URLs or data URIs, in image 1 through image 10 order. Each must be at least 256 pixels per dimension. Oversized images are automatically downscaled to at most 4 megapixels while preserving aspect ratio. The first controls auto aspect ratio. | items ≥ 1 · items ≤ 10 |
| version | const | The model version. | "latest" · default: "latest" |
| safety_tolerance | integer | Safety tolerance, from 0 (strictest) to 4. | 0 ≤ n ≤ 4 · default: 2 |
| resolution | enum | Output resolution tier. 4k can take several minutes. | 768sq | 1k | 1.5k | 2k | 4k · default: "1k" |
| sync_mode | boolean | Return the image as a data URI instead of storing it in request history. | default: false |
| aspect_ratio | enum | Output aspect ratio. Auto uses the first reference image when editing. | auto | 21:9 | 2:1 | 16:9 | 3:2 | 7:5 · +9 more · default: "auto" |
| enable_prompt_expansion | boolean | Expand the prompt while preserving its intent and reference roles. | default: false |
| output_format | enum | The format of the generated image. | jpeg | png · default: "jpeg" |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"blackforestlabs/flux-3/edit-image","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}