GET
/v1/schemas/fal/video/fal-ai%2Fkling-video%2Fv3%2F4k%2Fimage-to-video
Accept:
Request body
10 properties · 1 required · 2 $defs| property | type | description | constraints |
|---|---|---|---|
| start_image_url* | string | URL of the image to be used for the video | |
| elements | KlingV3ComboElementInput[] | Elements (characters/objects) to include in the video. Each example can either be an image set (frontal + reference images) or a video. Reference in prompt as @Element1, @Element2, etc. | nullable |
| cfg_scale | number | The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt. | 0 ≤ n ≤ 1 · default: 0.5 |
| shot_type | enum | The type of multi-shot video generation. 'intelligent' lets the model automatically determine shot structure. | customize | intelligent · default: "customize" |
| prompt | string | Text prompt for video generation. Either prompt or multi_prompt must be provided, but not both. | length ≤ 2500 · nullable |
| end_image_url | string | URL of the image to be used for the end of the video | nullable |
| negative_prompt | string | length ≤ 2500 · default: "blur, distort, and low quality" | |
| multi_prompt | KlingV3MultiPromptElement[] | List of prompts for multi-shot video generation. If provided, divides the video into multiple shots. | nullable |
| duration | enum | The duration of the generated video in seconds | 3 | 4 | 5 | 6 | 7 | 8 · +7 more · default: "5" |
| generate_audio | boolean | Whether to generate native audio for the video. Supports Chinese and English voice output. Other languages are automatically translated to English. For English speech, use lowercase letters; for acronyms or proper nouns, use uppercase. | default: true |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/kling-video/v3/4k/image-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}