curl --request POST \
--url https://api.aiid.edu.kg/omni-video/kling-4.0 \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"settings": {
"resolution": "720p",
"duration": 10,
"aspect_ratio": "16:9"
},
"options": {},
"contents": [
{
"type": "prompt",
"text": "A cinematic product shot with natural motion"
},
{
"type": "refer_image",
"url": "https://example.com/reference.jpg"
},
{
"type": "feature_video",
"url": "https://example.com/motion.mp4"
}
]
}
'{
"code": 0,
"message": "SUCCEED",
"request_id": "request_example",
"data": {
"id": "task_example",
"status": "submitted",
"create_time": 1792710000000,
"update_time": 1792710000000,
"external_id": ""
}
}Kling All-in-One Reference
This series supports OpenAI video generation formats (see the link Video generation Sora compatible formats).
Kling 4.0 native task API. Authenticate using this site’s Bearer API Key. The request body does not require model; settings.resolution=720p uses kling-4.0, while 1080p uses kling-4.0-1080p, with 1080p as the default. After successful creation, use the returned data.id to call GET /tasks?task_ids=task ID; separate multiple IDs with commas. The returned data is an array, and the result video is available at data[].outputs[].url.
Currently supported generation scenarios include prompts, first_frame, last_frame, refer_image, and feature_video. middle_frame, base_video, element, voice, audio references, callbacks, and custom external task IDs are not supported. Non-empty options.callback_url, non-empty options.external_task_id, non-empty contents.id, and other unsupported fields will return 400. options can be omitted or passed as an empty object; watermark_info.enabled=false can also be passed. Enabling watermarks is not currently supported. Supported durations range from 4 to 30 seconds, with a default of 10 seconds; 3 seconds is not supported. For text-to-video and reference scenarios, the default aspect ratio is 16:9; explicitly specifying adaptive will return 400. For first- and last-frame scenarios, explicitly specifying settings.aspect_ratio is not accepted; the aspect ratio is determined by the dimensions of the first frame image.
For general-purpose reference, contents must include a non-empty prompt and at least one supported media item. For legacy first/last-frame scenarios, you can provide first_frame, last_frame, or both, but processing support depends on the capabilities of the currently available model. Requests with incompatible capabilities will be rejected; frame images will not be silently converted to regular reference images. For new first/last-frame integrations, we recommend using the image-to-video endpoint. First/last frames cannot be used together with refer_image reference images or feature_video reference videos; mixing them returns a 400 error. In reference scenarios, refer_image reference images and feature_video reference videos can be combined. first_frame, last_frame, and refer_image can each contain at most one item, while feature_video can contain up to five items. Multi-reference image scenarios that rely on ID references are not currently supported.
curl --request POST \
--url https://api.aiid.edu.kg/omni-video/kling-4.0 \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"settings": {
"resolution": "720p",
"duration": 10,
"aspect_ratio": "16:9"
},
"options": {},
"contents": [
{
"type": "prompt",
"text": "A cinematic product shot with natural motion"
},
{
"type": "refer_image",
"url": "https://example.com/reference.jpg"
},
{
"type": "feature_video",
"url": "https://example.com/motion.mp4"
}
]
}
'{
"code": 0,
"message": "SUCCEED",
"request_id": "request_example",
"data": {
"id": "task_example",
"status": "submitted",
"create_time": 1792710000000,
"update_time": 1792710000000,
"external_id": ""
}
}Authorizations
Use Bearer Token authentication.
Format: Authorization: Bearer sk-xxxxxx
Body
- Option 1
- Option 2
Legacy first/last-frame compatibility scenarios: first_frame, last_frame, or both, subject to the capabilities of currently available models. Do not combine with reference assets; omit aspect_ratio, and the aspect ratio follows the first frame.
A non-empty prompt and supported media must both be provided. Image-to-video requests must include first_frame. Do not use first_frame/last_frame together with refer_image/feature_video; otherwise, a 400 error is returned. See the API documentation for media quantity limits. Legacy first-and-last-frame requests are validated based on the capabilities of currently available models; for new first-and-last-frame integrations, the image-to-video endpoint is recommended.
2Response
Success
0
Hide child attributes
Hide child attributes
Task ID on this site. Pass it as-is when querying.
submitted, processing, succeeded, failed Creation time, in Unix milliseconds.
Update time, in Unix milliseconds.