Kling 3.0 Motion Control API

Tài liệu tham chiếu API đầy đủ cho tính năng tạo video bằng Kling 3.0 Motion Control của Kuaishou.

Các biến thể mô hình

API này hỗ trợ một biến thể mô hình:

Kling 3.0 Motion Control

Điểm cuối

POST /api/v1/video/task

Tham số yêu cầu

Bắt buộc

Tùy chọn

Thời lượng đầu ra theo thời lượng video nguồn. Tham số duration không được hỗ trợ. Tỷ lệ khung hình đầu ra do nội dung đa phương tiện đầu vào quyết định và aspect_ratio không được hỗ trợ. Nhà cung cấp thượng nguồn chưa nêu rõ đầu vào nào quyết định tỷ lệ khung hình đầu ra hoặc quy tắc lựa chọn cụ thể.

Phí được tính dựa trên thời lượng video nguồn làm tròn đến số giây nguyên gần nhất và độ phân giải đầu ra đã chọn. Ví dụ: 5.4 giây được tính phí là 5 giây, còn 5.5 giây được tính là 6 giây.

Yêu cầu mẫu

Thay các URL đa phương tiện trong ví dụ bằng URL tệp của bạn đáp ứng các yêu cầu ở trên.

javascriptSao chép
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'kling-3.0-motion-control',
    prompt: 'Animate the character in the reference image using the dance movements from the reference video',
    images: ['https://example.com/character.jpg'],
    videos: ['https://example.com/dance-reference.mp4'],
    character_orientation: 'video',
    resolution: '720p',
    keep_original_sound: true
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Định dạng phản hồi

Phản hồi ban đầu

Trả về task_id để truy vấn định kỳ:

jsonSao chép
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Truy vấn định kỳ bằng GET /api/v1/video/{task_id} để kiểm tra trạng thái và lấy video đã tạo.

Giá trị trạng thái

• submitted: Tác vụ đã được tiếp nhận và đang chờ xử lý
• processing: Đang tạo video
• succeed: Đã hoàn tất tạo video
• failed: Tạo video thất bại

Các phương pháp khuyến nghị

1. Nội dung tham chiếu: Cung cấp đúng một ảnh và một video, kiểm tra định dạng, dung lượng tệp và kích thước khung hình trước khi gửi
2. Hướng: Kiểm tra lại thời lượng video tham chiếu khi thay đổi character_orientation, đặc biệt khi chọn "image"
3. Âm thanh gốc: Đặt keep_original_sound thành false để không giữ âm thanh gốc của video tham chiếu; nếu bỏ qua tham số này, âm thanh sẽ được giữ lại