GET

/v1/schemas/fal/image/wan/v2.6/image-to-image

Accept:

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

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

Request body

8 properties · 2 required · 1 $defs

property	type	description	constraints
prompt*	string	Text prompt describing the desired image. Supports Chinese and English. Max 2000 characters. Example: 'Generate an image using the style of image 1 and background of image 2'.	length ≥ 1
image_urls*	string[]	Reference images for editing (1-3 images required). Order matters: reference as 'image 1', 'image 2', 'image 3' in prompt. Resolution: 384-5000px each dimension. Max size: 10MB each. Formats: JPEG, JPG, PNG (no alpha), BMP, WEBP.
num_images	integer	Number of images to generate (1-4). Directly affects billing cost.	1 ≤ n ≤ 4 · default: 1
enable_safety_checker	boolean	Enable content moderation for input and output. Disabling it requires account authorization; unauthorized requests are always checked.	default: true
seed	integer	Random seed for reproducibility (0-2147483647). Same seed produces more consistent results.	nullable
image_size	ImageSize \| enum	Output image size. Use presets like 'square_hd', 'landscape_16_9', 'portrait_9_16', or specify exact dimensions with ImageSize(width=1280, height=720). Total pixels must be between 768768 and 12801280.	default: "square_hd"
negative_prompt	string	Content to avoid in the generated image. Max 500 characters.	nullable
enable_prompt_expansion	boolean	Enable LLM prompt optimization. Significantly improves results for simple prompts but adds 3-4 seconds processing time.	default: true

Types

1 $defs

ImageSizeobject

width	integer	The width of the generated image.	0 < n ≤ 14142 · default: 512
height	integer	The height 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":"wan/v2.6/image-to-image","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}