Chuyển đến nội dung chính
POST
/
kling
/
v1
/
videos
/
image2video
curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/image2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "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"
}
'
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "2032273942220931072",
    "task_status": "submitted",
    "task_info": {},
    "created_at": 1773366840306,
    "updated_at": 1773366840306
  }
}
Sử dụng endpoint này để tạo hiệu ứng chuyển động cho một hình ảnh nguồn thành video Kling.

Trước khi gọi

  • Cung cấp một URL hình ảnh công khai hoặc một chuỗi hình ảnh base64
  • Bắt đầu với model_name: kling-v2-master cho một request hiện đại tối thiểu
  • Giữ request đầu tiên ở mức đơn giản: một hình ảnh đầu vào, một prompt, không có khung hình cuối, không có motion mask

Quy trình tác vụ

1

Gửi request image-to-video

Tạo tác vụ và lưu task_id của Kling được trả về.
2

Poll tác vụ

Tiếp tục với Individual Queries để theo dõi trạng thái tác vụ cho đến khi đầu ra sẵn sàng.
3

Lưu kết quả

Lưu trữ asset đã hoàn tất nếu bạn cần giữ lại lâu hơn URL phân phối của nhà cung cấp.
Việc xác thực trực tiếp vào ngày 2026-03-12 xác nhận rằng một request kling-v2-master dựa trên URL đã được chấp nhận và trả về task_status: submitted.
Để xem tài liệu tham khảo đầy đủ về tham số, 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
image
string
mặc định:example
bắt buộc

Source image as a Base64 string or public URL. Accepted formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300×300 px.

prompt
string

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).

model_name
string

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

image_tail
string

Tail-frame reference image as a Base64 string or public URL. Same format requirements as image. Controls the last frame of the generated video.

cfg_scale
number

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

duration
string

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

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