GET

/v1/schemas/fal/image/krea/v3/edit

Accept:

kind inputactivity imagehash 44d784c8…extracted Nov 6, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. upstream-spec Source trace `b681c9327f1953fa9125ee27c9ae905ab02f8ca430016d8bf1f4771c02eefcd5` { "fetchedAt": 1793941202, "extractorVersion": "1", "verifiedAt": null }

Request body

11 properties · 1 required · 2 $defs

property	type	description	constraints
image_urls*	string[]	Reference images to edit or combine (1-8). Order sets the <image-N> tags.	items ≥ 1 · items ≤ 8
regional_edit	boolean	With high or ultra reasoning, true preserves pixels outside the edit regions on the chosen canvas; false disables automatic region cropping and preservation. Omit to retain automatic preservation. With image_size=auto, keeps the canvas dimensions; an explicit image_size preserves the resized input. Billing uses the generated render dimensions. Use PNG for lossless output.	nullable
seed	integer	Latent noise seed. Use a new seed when editing a previous output again.	nullable
output_format	enum	Output image format.	png \| jpeg · default: "png"
reasoning_level	enum	How much effort the prompt expander spends reasoning about the given editing task. Higher reasoning effort means slower generation time.	medium \| high \| ultra · default: "medium"
prompt	string	Edit instruction. Refer to images as <image-1>, <image-2>, ... and regions as @label. May be omitted when a region has a note.	length ≤ 5000 · default: ""
enable_safety_checker	boolean	Check output images for unsafe content. Disabling requires account authorization.	default: true
regions	EditRegion[]	Bounding boxes on reference images, with optional labels and editing notes. Requires high or ultra reasoning.	items ≤ 24
image_size	ImageSize \| enum	Output size, rounded up to multiples of 16, at most 4,220,160 total pixels (1680×2512). auto lets the prompt expander pick the aspect ratio at about 2048×2048.	default: "auto"
negative_prompt	string	What to keep out of the image.	length ≤ 1024 · default: ""
sync_mode	boolean	Return images as data URIs instead of saving them in request history.	default: false

Types

2 $defs

EditRegionobject

y*	number	Top edge as a fraction of image height.	0 ≤ n < 1
height*	number	Height as a fraction of image height.	0 < n ≤ 1
image_idx*	integer	Zero-based index into image_urls.	n ≥ 0
note	string	Edit instruction for this region; may reference other @labels.	length ≤ 5000 · default: ""
label	string	Refer to this region as @label. Defaults to its one-based position.	length ≥ 1 · length ≤ 64 · nullable
width*	number	Width as a fraction of image width.	0 < n ≤ 1
x*	number	Left edge as a fraction of image width.	0 ≤ n < 1

ImageSizeobject

height	integer	The height of the generated image.	0 < n ≤ 14142 · default: 512
width	integer	The width of the generated image.	0 < n ≤ 14142 · default: 512

Validate a payload

before you spend tokens

shell

$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"krea/v3/edit","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}