Chuyển đến nội dung chính
POST
/
kling
/
v1
/
videos
/
multi-image2video
Create a Kling multi-image-to-video task
curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/multi-image2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model_name": "kling-v1-6",
  "duration": "5",
  "image_list": [
    {
      "image": "https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg"
    },
    {
      "image": "https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg"
    },
    {
      "image": "https://filesystem.site/cdn/20250414/chxiLc2O45zoLT8BCrQ6WQlTvGDDnK.png"
    },
    {
      "image": "https://filesystem.site/cdn/20250414/chxiLc2O45zoLT8BCrQ6WQlTvGDDnK.png"
    }
  ],
  "prompt": "The astronauts got up and left."
}
'
{
  "code": 0,
  "message": "SUCCEED",
  "data": {
    "task_id": "861309198188019719",
    "task_status": "submitted",
    "task_info": {},
    "created_at": 1773380633979,
    "updated_at": 1773380633979
  }
}
Sử dụng endpoint này khi một ảnh nguồn là chưa đủ và bạn muốn Kling tạo chuyển động từ nhiều ảnh tham chiếu.

​
Trước khi gọi

  • Chuẩn bị từ 2 đến 4 ảnh trong image_list
  • Bắt đầu với model_name: kling-v1-6 hoặc một model hiện tại khác mà bạn đã xác thực
  • Giữ lần kiểm thử đầu tiên thật đơn giản: một prompt ngắn, không có motion mask, không có thiết lập callback bổ sung

​
Luồng tác vụ

1

Gửi yêu cầu nhiều ảnh

Gửi danh sách ảnh, prompt và thời lượng, sau đó lưu lại Kling task_id được trả về.
2

Thăm dò tác vụ

Tiếp tục với Truy vấn riêng lẻ cho đến khi tác vụ đạt trạng thái kết thúc.
3

Lưu trữ kết quả

Lưu video đã hoàn tất nếu bạn cần giữ lại lâu hơn thời hạn của URL phân phối từ nhà cung cấp.
Việc xác thực trực tiếp vào ngày 2026-03-13 đã xác nhận rằng một yêu cầu tối thiểu với hai ảnh đã được chấp nhận và trả về task_status: submitted.
Để xem tham chiếu tham số đầy đủ, hãy xem tài liệu Kling chính thức.

Ủy quyền

​
Authorization
string
header
bắt buộc

Bearer token authentication. Use your CometAPI key.

Nội dung

application/json
​
model_name
string
mặc định:kling-v1-6
bắt buộc

Kling model variant to use. See the Models page for current options.

​
duration
string
mặc định:5
bắt buộc

Output video length in seconds. Options: 5, 10.

​
image_list
object[]
bắt buộc

2 to 4 source images. Each item provides an image field as a public URL or Base64 string (without data: prefix). Accepted formats: JPG, JPEG, PNG. Maximum 10 MB per image, minimum 300×300 px, aspect ratio between 1:2.5 and 2.5:1.

​
prompt
string
mặc định:The cat turns its head and blinks.
bắt buộc

Text prompt describing the desired motion. Maximum 500 characters.

​
negative_prompt
string

Elements to exclude from the video. Maximum 200 characters.

​
callback_url
string

Webhook URL to receive task status updates when the task completes.

​
mode
string

Generation mode. std for standard (faster), pro for professional (higher quality).

​
cfg_scale
number

Prompt adherence strength. Higher values follow the prompt more closely. Range: 0–1.

​
static_mask
string

Static brush mask image as a Base64 string or public URL. White areas are frozen in place during video generation. Must match the aspect ratio and resolution of the input image.

​
dynamic_masks
object

Dynamic brush configuration. Up to 6 groups, each containing a painted-area mask and a motion trajectory.

​
external_task_id
string

Custom task id for your own tracking. Does not replace the system-generated task id but can be used to query tasks. Must be unique per user.

Phản hồi

200 - application/json

Task accepted.

​
code
integer
bắt buộc

Error code; specifically define the error code

​
message
string
bắt buộc

error message

​
data
object
bắt buộc