Ảnh thành video

Tạo video Kling 4.0 từ khung đầu, khung đầu/cuối hoặc nhiều khung hình chính.

Kết hợp prompt và khung chính trong contents, tối đa 10 ảnh mỗi tác vụ. API không có aspect_ratio; dùng ảnh theo tỷ lệ đích.

POST/kling/image-to-video/kling-4.0

Dùng khung đầu, đầu/cuối hoặc nhiều khung chính; tối đa 10 ảnh mỗi tác vụ. Tỷ lệ theo ảnh tham chiếu, không có aspect_ratio.

Xác thực

bearerAuth

Xác thựcBearer <token>

Dùng API Key nền tảng: Authorization: Bearer your-api-key.

Vị trí truyền: header

Nội dung yêu cầu

application/json

Định nghĩa kiểu TypeScript

Sử dụng kiểu request body trong TypeScript.

contents*array<|>

Cần ít nhất ảnh; prompt tùy chọn. Tối đa 10 ảnh khung chính, không bắt buộc đồng thời có đầu/giữa/cuối.

Số phần tử1 <= items

settings?

options?

Nội dung phản hồi

`application/json`

curl -X POST "https://api.agtcloud.cn/kling/image-to-video/kling-4.0" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "type": "prompt",
        "text": "Làm sóng trong @first chuyển động chậm, giữ máy quay ổn định."
      },
      {
        "type": "first_frame",
        "id": "first",
        "url": "https://example.com/first.jpg"
      }
    ],
    "settings": {
      "duration": 5,
      "resolution": "720p"
    }
  }'

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "REQUEST_ID",
  "data": {
    "id": "123456789012345678",
    "status": "submitted",
    "message": "",
    "create_time": 1792713600000,
    "update_time": 1792713600000
  }
}

Quy tắc ảnh và tham chiếu

contents hỗ trợ first_frame (đầu), middle_frame (giữa), last_frame (cuối). Mục prompt type: "prompt" là tùy chọn. Ví dụ yêu cầu gồm khung đầu, đầu/cuối và nhiều khung chính.

Mục	Yêu cầu
Nguồn ảnh	`url` bắt buộc; URL hoặc Base64
Định dạng/kích thước	JPG, JPEG, PNG; tối đa 30MB mỗi ảnh
Kích thước ảnh	Rộng/cao ít nhất 300px, tỷ lệ 2:5～5:2
Số ảnh	Tối đa 10 mỗi tác vụ
ID tham chiếu tài nguyên	`id` tùy chọn; không trùng trong tác vụ

Để chỉ ảnh trong prompt, đặt id, ví dụ "id": "first" tương ứng @first. id là tham chiếu trong yêu cầu này, không phải ID tác vụ trả về.

Lỗi thường gặp và cách xử lý

Phản hồi/lỗi	Kiểm tra và xử lý
HTTP 401, `Invalid token`	Kiểm tra định dạng Bearer và trang của API Key
HTTP 400, `contents cannot be empty`	Cung cấp mảng `contents` không rỗng
HTTP 400, `contents must contain at least one of first_frame, middle_frame, last_frame`	Cần ít nhất một ảnh khung chính; chỉ prompt là không đủ
HTTP 400, `must have a non-blank url`	Điền `url` không rỗng cho khung tương ứng
HTTP 400, `contents[0].type ... is invalid`	Kiểm tra mục tại chỉ số báo lỗi; dùng kiểu khung chính/prompt được hỗ trợ
HTTP 400, `invalid_request` hoặc `invalid JSON request body`	Kiểm tra JSON và kiểu; `contents` phải là mảng, không phải chuỗi

HTTP 400 có thể trả code/message/data hoặc đối tượng error. fail_to_fetch_task không nhất thiết là lỗi truy vấn; đọc nguyên nhân kiểm tra tài nguyên ở message. Trường này có thể là chuỗi JSON, không phải đối tượng đã phân tích. Lưu ID yêu cầu, không cung cấp API Key.

Xác thực

Nội dung yêu cầu

Nội dung phản hồi

200application/json

400application/json

401application/json

Quy tắc ảnh và tham chiếu

Lỗi thường gặp và cách xử lý

`application/json`

`application/json`

`application/json`