v1

latestOpenAPI 3.1.02026-07-267724480.0 KB

Create a Kling multi-image-to-video task

Submit 2 to 4 images plus a motion prompt and receive a task id for later polling.

post/kling/v1/videos/multi-image2video

Request body

model_name'kling-v1-6'

Kling model variant for multi-image video. Omit to use kling-v1-6.

promptstring

Text prompt describing the desired motion and scene.

negative_promptstring

Elements to avoid in the generated video.

mode'std' | 'pro'

Generation mode. Use std or pro; omitted requests use std.

durationstring

Output video length in seconds. Use 5 or 10; omitted requests use 5.

aspect_ratio'16:9' | '9:16' | '1:1'

Requested frame aspect ratio when the model needs an explicit frame shape.

callback_urlstring

Webhook URL to receive task status updates.

external_task_idstring

Custom task id for your own tracking. Must be unique per account.

Response

Task accepted.

codeinteger required

Error code; specifically define the error code

messagestring required

error message

Example response

{
  "code": 0,
  "message": "SUCCEED",
  "data": {
    "task_id": "861309198188019719",
    "task_status": "submitted",
    "task_info": {},
    "created_at": 1773380633979,
    "updated_at": 1773380633979
  }
}