GET
/v1/schemas/fal/image/kling/v4/image-to-image
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source traceea6b6088aef405a3f2a3798404b3cf93f4f7c5f519dc3956e6b24f9ea03a5ce7{
"fetchedAt": 1794978001,
"extractorVersion": "2",
"verifiedAt": null
} |
Request body
9 properties · 2 required · 1 $defs| property | type | description | constraints |
|---|---|---|---|
| image_urls* | string[] | Reference images (1-10). | items ≥ 1 · items ≤ 10 |
| prompt* | string | Text prompt. Reference images as @Image1, @Image2, ... and elements as @Element1, @Element2, ... | length ≥ 1 · length ≤ 50000 |
| result_type | enum | 'single' returns independent images; 'series' returns a coherent set of related images. | single | series · default: "single" |
| aspect_ratio | enum | Aspect 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" |
| elements | KlingV4ImageElement[] | Elements, referenced as @Element1, @Element2, ... (max 7). Images and elements combined must not exceed 10. | items ≤ 7 · nullable |
| sync_mode | boolean | If `True`, the media will be returned as a data URI. | default: false |
| num_images | integer | Number of independent images to generate (1-9). Only used when result_type is 'single'. | 1 ≤ n ≤ 9 · default: 1 |
| resolution | enum | Output resolution. | 2K | 4K | 8K · default: "2K" |
| series_amount | integer | "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 $defsKlingV4ImageElementobject
| frontal_image_url* | string | The 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 tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"kling/v4/image-to-image","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}