04-Multi-Image-to-Video
(Elements) Multi-Image to Video
Doc version: v1.0.0 | Last updated: 2026-06-11 This platform fully supports the Kling AI official video generation API. Requests and responses are transparently proxied; parameter semantics are identical to the official API.
Create Task
POST https://platform.dataeyes.ai/kling/v1/videos/multi-image2videoRequest Headers
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
Content-Type | string | Yes | application/json | Data Exchange Format |
Authorization | string | Yes | Authentication information, refer to API authentication |
Request Body
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
model_name | string | No | kling-v1-6 | Model Name Options: kling-v1-6 |
image_list | array | Yes | Reference Image List - Support up to 4 images, load with key:value format as follows: - Please directly upload the image with selected subject since there is no cropping logic on the API side - Supports image input as either Base64-encoded string or URL (ensure the URL is publicly accessible) - Important: When using Base64, do NOT add any prefix like data:image/png;base64,. Submit only the raw Base64 string.- Correct Base64 format: - Incorrect Base64 format (with data: prefix): - Supported image formats: .jpg / .jpeg / .png - Image file size must not exceed 10MB. Image dimensions must be at least 300px. Aspect ratio must be between 1:2.5 and 2.5:1 | |
image | string | Yes | Image URL or Base64 string | |
prompt | string | Yes | Positive text prompt - Cannot exceed 2500 characters | |
negative_prompt | string | No | Negative text prompt - Cannot exceed 2500 characters | |
mode | string | No | std | Video generation mode Options: std, pro- std: Standard Mode, which is cost-effective - pro: Professional Mode, generates higher quality video output Different model versions and video modes have different support ranges. For details, see Capability Map |
duration | string | No | 5 | Video Length, unit: s (seconds) Options: 5, 10 |
aspect_ratio | string | No | 16:9 | The aspect ratio of the generated video frame (width:height) Options: 16:9, 9:16, 1:1 |
watermark_info | object | No | Whether to generate watermarked results simultaneously - Defined by the enabled parameter, format: - true: generate watermarked result, false: do not generate - Custom watermarks are not currently supported | |
callback_url | string | No | The callback notification address for the result of this task. If configured, the server will actively notify when the task status changes - The specific message schema of the notification can be found in Callback Protocol | |
external_task_id | string | No | Customized Task ID - User-defined task ID. It will not override the system-generated task ID, but supports querying tasks by this ID - Please note that it must be unique for each user | |
| Parameter Format Details |
image_list"image_list":[
{ "image":"image_url" },
{ "image":"image_url" },
{ "image":"image_url" },
{ "image":"image_url" }
]iVBORw0KGgoAAAANSUhEUgAAAAUA...data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA...watermark_info"watermark_info": { "enabled": boolean }Request Example
curl --request POST \
--url https://platform.dataeyes.ai/kling/v1/videos/multi-image2video \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model_name": "kling-v1-6",
"image_list": [
{ "image": "https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dog.png" },
{ "image": "https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dog_cloth.png" }
],
"prompt": "A white Bichon Frise wearing a red Northeast-style floral cotton jacket, licking its paw",
"negative_prompt": "",
"mode": "pro",
"duration": "5",
"aspect_ratio": "16:9",
"callback_url": "",
"external_task_id": ""
}'Response Example
{
"code": 0, // Error code; Specific definitions can be found in "Error Code"
"message": "string", // Error message
"request_id": "string", // Request ID, generated by the system, used to track requests and troubleshoot problems
"data": {
"task_id": "string", // Task ID, generated by the system
"task_status": "string", // Task status, Enum values: submitted, processing, succeed, failed
"created_at": 1722769557708, // Task creation time, Unix timestamp, unit: ms
"updated_at": 1722769557708 //Task update time, Unix timestamp, unit: ms
}
}Query Task (Single)
GET https://platform.dataeyes.ai/kling/v1/videos/multi-image2video/{id}Request Headers
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
Content-Type | string | Yes | application/json | Data Exchange Format |
Authorization | string | Yes | Authentication information, refer to API authentication |
Request Example
curl --request GET \
--url https://platform.dataeyes.ai/kling/v1/videos/multi-image2video/{task_id} \
--header 'Authorization: Bearer <token>'Response Example
{
"code": 0, // Error code; Specific definitions can be found in "Error Code"
"message": "string", // Error message
"request_id": "string", // Request ID, generated by the system, used to track requests and troubleshoot problems
"data": {
"task_id": "string", // Task ID, generated by the system
"task_status": "string", // Task status, Enum values: submitted, processing, succeed, failed
"task_status_msg": "string", // Task status message, displays failure reason when task fails (such as content moderation triggers)
"task_info": { //Task creation parameters
"external_task_id": "string" //User-defined task ID
},
"task_result": {
"videos": [
{
"id": "string", // Generated video ID; globally unique
"url": "string", // URL for generating videos (Please note that for security purposes, generated images/videos will be deleted after 30 days. Please save them promptly.)
"watermark_url": "string", // Watermarked video download URL, anti-hotlinking format
"duration": "string" //Total video duration, unit: s (seconds)
}
]
},
"watermark_info": {
"enabled": boolean
},
"final_unit_deduction": "string", // Final unit deduction for the task
"created_at": 1722769557708, // Task creation time, Unix timestamp, unit: ms
"updated_at": 1722769557708 //Task update time, Unix timestamp, unit: ms
}
}Query Task (List)
GET https://platform.dataeyes.ai/kling/v1/videos/multi-image2videoRequest Headers
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
Content-Type | string | Yes | application/json | Data Exchange Format |
Authorization | string | Yes | Authentication information, refer to API authentication |
Request Example
curl --request GET \
--url 'https://platform.dataeyes.ai/kling/v1/videos/multi-image2video?pageNum=1&pageSize=30' \
--header 'Authorization: Bearer <token>'Response Example
{
"code": 0, // Error code; Specific definitions can be found in "Error Code"
"message": "string", // Error message
"request_id": "string", // Request ID, generated by the system, used to track requests and troubleshoot problems
"data": [
{
"task_id": "string", // Task ID, generated by the system
"task_status": "string", // Task status, Enum values: submitted, processing, succeed, failed
"task_status_msg": "string", // Task status message, displays failure reason when task fails (such as content moderation triggers)
"task_info": { //Task creation parameters
"external_task_id": "string" //User-defined task ID
},
"task_result": {
"videos": [
{
"id": "string", // Generated video ID; globally unique
"url": "string", // URL for generating videos (Please note that for security purposes, generated images/videos will be deleted after 30 days. Please save them promptly.)
"watermark_url": "string", // Watermarked video download URL, anti-hotlinking format
"duration": "string" //Total video duration, unit: s (seconds)
}
]
},
"watermark_info": {
"enabled": boolean
},
"final_unit_deduction": "string", // Final unit deduction for the task
"created_at": 1722769557708, // Task creation time, Unix timestamp, unit: ms
"updated_at": 1722769557708 //Task update time, Unix timestamp, unit: ms
}
]
}