GET

/v1/schemas/fal/image/fal-ai/wan-25-preview/image-to-image

Accept:

kind inputactivity imagehash 3b3a8cfb…extracted Aug 10, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. Source trace `01f3e7f53e293748531db4eb3167aa6b7d9fb25f5bab082ab0bf79f8835045e7` { "fetchedAt": 1786338105, "extractorVersion": "1", "verifiedAt": null }

Request body

7 properties · 2 required · 1 $defs

property	type	description	constraints
prompt*	string	The text prompt describing how to edit the image. Max 2000 characters.	length ≥ 1
image_urls*	string[]	URLs of images to edit. For single-image editing, provide 1 URL. For multi-reference generation, provide up to 2 URLs. If more than 2 URLs are provided, only the first 2 will be used.
num_images	integer	Number of images to generate. Values from 1 to 4.	1 ≤ n ≤ 4 · default: 1
seed	integer	Random seed for reproducibility. If None, a random seed is chosen.	nullable
image_size	ImageSize \| enum	The size of the generated image. Width and height must be between 384 and 1440 pixels.	default: "square"
enable_safety_checker	boolean	If set to true, the safety checker will be enabled. Disabling it requires account authorization; unauthorized requests are always checked.	default: true
negative_prompt	string	Negative prompt to describe content to avoid. Max 500 characters.	nullable

Types

1 $defs

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":"fal-ai/wan-25-preview/image-to-image","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}