---
title: "Create a Kling multi-image-to-video task"
method: POST
path: "/kling/v1/videos/multi-image2video"
---

# Create a Kling multi-image-to-video task

`POST /kling/v1/videos/multi-image2video`

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

## Request body

- object
  - `model_name` 'kling-v1-6' — Kling model variant for multi-image video. Omit to use `kling-v1-6`.
  - `image_list` object[], required — Input image references. Provide 1 to 4 items that meet Kling pixel requirements; very small thumbnails are rejected.
    - `image` string, required — Image URL or base64 image string.
  - `prompt` string — Text prompt describing the desired motion and scene.
  - `negative_prompt` string — Elements to avoid in the generated video.
  - `mode` 'std' | 'pro' — Generation mode. Use `std` or `pro`; omitted requests use `std`.
  - `duration` string — 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_url` string — Webhook URL to receive task status updates.
  - `external_task_id` string — Custom task id for your own tracking. Must be unique per account.

## Response `200`

Task accepted.

- object
  - `code` integer, required — Error code; specifically define the error code
  - `message` string, required — error message
  - `data` object, required
    - `task_id` string, required — Task ID, system generated
    - `task_status` string, required — Task status, enumerated values: submitted, processing, succeed, failed.
    - `task_status_msg` string
    - `task_info` object
    - `created_at` integer, required — Task creation time, Unix timestamp, in ms.
    - `updated_at` integer, required — Task update time, Unix timestamp, in ms.

---

[API](https://skmtc.net/cometapi/apis/create-api-key.md) · [All operations](https://skmtc.net/cometapi/apis/create-api-key/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cometapi/create-api-key/versions/0863102dbf34/schema)