GET

/v1/schemas/fal/image/kling/v4/image-to-image

kind inputactivity imagehash 872ca3b1…extracted Nov 18, 2026version currentsource upstream spec ↗
fieldrecorded source
schemaSource linked above.

upstream-spec

Source trace
ea6b6088aef405a3f2a3798404b3cf93f4f7c5f519dc3956e6b24f9ea03a5ce7
{
  "fetchedAt": 1794978001,
  "extractorVersion": "2",
  "verifiedAt": null
}

Request body

9 properties · 2 required · 1 $defs
propertytypedescriptionconstraints
image_urls*string[]Reference images (1-10).items ≥ 1 · items ≤ 10
prompt*stringText prompt. Reference images as @Image1, @Image2, ... and elements as @Element1, @Element2, ...length ≥ 1 · length ≤ 50000
result_typeenum'single' returns independent images; 'series' returns a coherent set of related images.single | series · default: "single"
aspect_ratioenumAspect ratio of generated images. 'auto' picks one from the input content.auto | 16:9 | 9:16 | 1:1 | 4:3 | 3:4 · +3 more · default: "auto"
elementsKlingV4ImageElement[]Elements, referenced as @Element1, @Element2, ... (max 7). Images and elements combined must not exceed 10.items ≤ 7 · nullable
sync_modebooleanIf `True`, the media will be returned as a data URI.default: false
num_imagesintegerNumber of independent images to generate (1-9). Only used when result_type is 'single'.1 ≤ n ≤ 9 · default: 1
resolutionenumOutput resolution.2K | 4K | 8K · default: "2K"
series_amountinteger | "auto"Number of images in the series (2-10), or 'auto' to let the model choose. Only used when result_type is 'series'.default: 4

Types

1 $defs

KlingV4ImageElementobject

frontal_image_url*stringThe frontal image of the element (main view).
reference_image_urls*string[]Additional views of the element from different angles (1-3).items ≥ 1 · items ≤ 3

Validate a payload

before you spend tokens
shell
$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"kling/v4/image-to-image","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}