Kling Video API

Trang này mô tả cách gọi model video Kling của Kuaishou, kling-3.0-turbo. Giống các model video khác, model này được tạo bằng POST /v1/videos và truy vấn bằng GET /v1/videos/{id}; xác thực, tải lên tư liệu, trạng thái truy vấn định kỳ, tải kết quả và xử lý lỗi xem Quy chuẩn gọi Video API đầy đủ. Trang này chỉ trình bày các trường và quy tắc riêng của Kling.

Cập nhật ngày 2026-10-10. Model Kling chỉ hỗ trợ truy vấn định kỳ: không đặt callback_url khi tạo, nếu không yêu cầu sẽ bị từ chối.

Model

Dùng resolution để chọn mức độ phân giải đầu ra, và yêu cầu được tính phí theo mức đó; không phân biệt chữ hoa/thường (4k và 4K là như nhau). Nếu không truyền, dùng mức thấp nhất 720p. Điền mức không được hỗ trợ sẽ trả về 400, hệ thống không tự hạ mức.

Quy tắc chung

• Thời lượng: số giây nguyên từ 4 đến 15 trong duration (hoặc seconds dạng chuỗi); mặc định 5 giây.
• Tỷ lệ khung hình: ratio (hoặc aspect_ratio) nhận 16:9, 9:16, 1:1.
• Prompt: prompt bắt buộc, tối đa 2000 ký tự.
• Tạo âm thanh: hỗ trợ generate_audio (boolean).
• Âm thanh tham chiếu: không hỗ trợ; gửi lên sẽ trả về 400.
• Trường tùy chọn: negative_prompt (prompt phủ định), seed (số nguyên).

Ảnh và video tham chiếu

Ảnh tham chiếu đặt trong images ở cấp gốc, video tham chiếu đặt trong metadata.referenceVideos. Tối đa 30 ảnh (gồm khung hình đầu và cuối) và 10 video.

{
  "model": "kling-3.0-turbo",
  "resolution": "1080p",
  "prompt": "Giữ ngoại hình sản phẩm trong ảnh và nhịp máy quay của video tham chiếu, sản phẩm xoay chậm trên mặt bàn",
  "duration": 10,
  "ratio": "16:9",
  "generate_audio": true,
  "images": [
    "https://cdn.example.com/product-front.jpg",
    "https://cdn.example.com/product-side.jpg"
  ],
  "metadata": {
    "referenceVideos": ["https://cdn.example.com/motion-reference.mp4"]
  }
}

Khung hình đầu và cuối

Khung hình đầu và khung hình cuối đặt trong metadata.firstFrame và metadata.lastFrame. lastFrame phải đi kèm firstFrame. Kling cho phép gửi khung hình đầu và cuối cùng với ảnh tham chiếu, tổng cộng không quá 30 ảnh.

{
  "model": "kling-3.0-turbo",
  "resolution": "4k",
  "prompt": "Máy quay lướt từ bờ biển lúc bình minh sang cùng vịnh biển lúc hoàng hôn",
  "duration": 5,
  "ratio": "16:9",
  "metadata": {
    "firstFrame": "https://cdn.example.com/start.jpg",
    "lastFrame": "https://cdn.example.com/end.jpg"
  }
}

Tải tệp lên

Cũng có thể gửi trực tiếp 1 tệp ảnh cục bộ bằng multipart/form-data, trong trường input_reference; khi đó đừng gửi images hoặc image trong cùng yêu cầu. Video tham chiếu không thể gửi dưới dạng tệp, hãy lấy URL trước theo Tải lên tư liệu cục bộ.

Tên model cũ

Các tên model cũ có hậu tố mức độ phân giải kling-3.0-turbo-720p, kling-3.0-turbo-1080p, kling-3.0-turbo-2k, kling-3.0-turbo-4k đã ngừng cung cấp từ 2026-10-10; gửi yêu cầu bằng các tên này sẽ trả về lỗi. Hãy dùng kling-3.0-turbo và chọn mức bằng resolution.