GET

/v1/schemas/fal/image/alibaba/qwen-image-3/edit

kind inputactivity imagehash e4c807c1…extracted Aug 15, 2026version currentsource upstream spec ↗
fieldrecorded source
schemaSource linked above.

upstream-spec

Source trace
f0d656de5576bb93483ca8a3bebcaa0c8cbad33d06df4931c668f7ac3f108308
{
  "fetchedAt": 1786770058,
  "extractorVersion": "1",
  "verifiedAt": null
}

Request body

10 properties · 2 required · 1 $defs
propertytypedescriptionconstraints
prompt*stringText prompt describing the desired edit. Supports Chinese and English. Max 5000 characters.length ≥ 1 · length ≤ 5000
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-2048px each dimension. Max size: 10MB each. Formats: JPEG, JPG, PNG (no alpha), WEBP.
enable_safety_checkerbooleanEnable content moderation for input and output. Disabling it requires account authorization; unauthorized requests are always checked.default: true
enable_prompt_expansionbooleanEnable automatic LLM prompt rewriting for better results.default: true
image_sizeImageSize | enumThe size of the generated image. If not provided, the model determines the resolution automatically. Total number of pixels must be between 512x512 and 2048x2048.nullable
seedintegerRandom seed for reproducibility (0-2147483647).nullable
num_imagesintegerThe number of images to generate.1 ≤ n ≤ 6 · default: 1
output_formatenumThe format of the generated image.jpeg | png | webp · default: "png"
sync_modebooleanIf `True`, the media will be returned as a data URI and the output data won't be available in the request history.default: false
negative_promptstringContent to avoid in the generated image. Max 500 characters.length ≤ 500 · nullable

Types

1 $defs

ImageSizeobject

widthintegerThe width of the generated image.0 < n ≤ 14142 · default: 512
heightintegerThe 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":"alibaba/qwen-image-3/edit","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}