Kling 4.0 API

Tài liệu tham chiếu API đầy đủ cho các mô hình tạo video Kling 4.0 của Kuaishou.

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

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

So sánh nhanh

Tỷ lệ khung hình được hỗ trợ

Text-to-Video, Image-to-Video, Reference-to-Video và Video Edit hỗ trợ:

16:9, 9:16, 1:1, 21:9

Giá trị mặc định là 16:9. Video Extend không hỗ trợ tham số aspect_ratio; đầu ra tuân theo tỷ lệ khung hình của video nguồn.

Tùy chọn độ phân giải

Cả năm mô hình đều yêu cầu resolution và duration. Hãy cung cấp rõ resolution dù giá trị mặc định là 720p. duration không có giá trị mặc định.

Kling 4.0 Text to Video

Điểm cuối

POST /api/v1/video/task

Tham số yêu cầu

Bắt buộc

Tùy chọn

Ví dụ yêu cầu

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-v4.0-text-to-video',
    prompt: 'A drone flying over a mountain range at sunrise, smooth forward camera movement',
    resolution: '720p',
    duration: 5,
    aspect_ratio: '16:9'
  })
});

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

Kling 4.0 Image to Video

Tham số yêu cầu

Bắt buộc

Tùy chọn

Khi cung cấp cả image_url và image_end_url, key_frames có thể chứa tối đa 8 hình ảnh. Các khung hình trung gian được sử dụng theo thứ tự trong mảng; thời điểm xuất hiện do mô hình quyết định.

Ví dụ yêu cầu

javascriptSao chép
{
  model_name: 'kling-v4.0-image-to-video',
  prompt: 'Camera slowly pulls back from the character to reveal the surrounding mountain landscape',
  image_url: 'https://example.com/start-frame.jpg',
  image_end_url: 'https://example.com/end-frame.jpg',
  key_frames: [
    'https://example.com/middle-frame-1.jpg',
    'https://example.com/middle-frame-2.jpg'
  ],
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9'
}

Kling 4.0 Reference to Video

Tham số yêu cầu

Bắt buộc

Tùy chọn

Hình ảnh, video và âm thanh tham chiếu đều là tùy chọn. Bạn có thể cung cấp một loại tư liệu, kết hợp nhiều loại hoặc bỏ qua cả ba.

duration của đầu ra được đặt độc lập trong khoảng 3-30 giây và không được tính vào giới hạn tổng thời lượng của các video tham chiếu.

Ví dụ yêu cầu

javascriptSao chép
{
  model_name: 'kling-v4.0-reference-to-video',
  prompt: 'Use the character from the reference image, follow the camera movement in the reference video, and use the reference audio for voice guidance',
  images: ['https://example.com/character-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4'],
  audios: ['https://example.com/voice-reference.mp3'],
  keep_original_sound: false,
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9'
}

Kling 4.0 Video Edit

Tham số yêu cầu

Bắt buộc

Tùy chọn

Ví dụ yêu cầu

javascriptSao chép
{
  model_name: 'kling-v4.0-video-edit',
  prompt: 'Replace the background with warm sunset colors while preserving the subject and camera movement',
  video_url: 'https://example.com/source.mp4',
  images: ['https://example.com/sunset-reference.jpg'],
  keep_original_sound: true,
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9'
}

Kling 4.0 Video Extend

Tham số yêu cầu

Bắt buộc

Tùy chọn

Không gửi aspect_ratio; đầu ra tuân theo tỷ lệ khung hình của video nguồn. Kết quả chứa toàn bộ video, bao gồm video nguồn và đoạn nối thêm. Tổng thời lượng bằng thời lượng video nguồn cộng với duration.

Ví dụ yêu cầu

javascriptSao chép
{
  model_name: 'kling-v4.0-video-extend',
  prompt: 'Continue the camera movement forward through the valley as the sun rises above the mountains',
  video_url: 'https://example.com/source.mp4',
  image_end_url: 'https://example.com/target-end-frame.jpg',
  resolution: '720p',
  duration: 5
}

Quy tắc tính phí

Text-to-Video và Image-to-Video được tính phí theo độ phân giải đầu ra và thời lượng video được tạo. Video Extend được tính phí theo độ phân giải và thời lượng đoạn nối thêm, không phải toàn bộ thời lượng video trả về.

Các yêu cầu Reference-to-Video có video tham chiếu và các yêu cầu Video Edit tính cả thời lượng video đầu vào lẫn đầu ra ở độ phân giải đã chọn. Thời lượng tính phí của video đầu vào tối thiểu là 3 giây và tối đa là 30 giây. Khi có nhiều video tham chiếu, các giới hạn này áp dụng cho tổng thời lượng, không áp dụng riêng cho từng video. Giới hạn thời lượng tính phí không quy định giới hạn tải lên.

Khi không có video tham chiếu, Reference-to-Video áp dụng quy tắc tính phí giống Text-to-Video, bất kể có cung cấp hình ảnh hoặc âm thanh tham chiếu hay không. Với yêu cầu có video đầu vào, hình ảnh tham chiếu, âm thanh tham chiếu và keep_original_sound được hỗ trợ không phát sinh khoản phí riêng.

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

Phản hồi ban đầu

Tất cả mô hình đề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.

Các 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: Đã tạo video thành công
• failed: Tạo video thất bại

Cách sử dụng khuyến nghị

1. Tham số bắt buộc: Luôn cung cấp resolution và duration, kể cả khi sử dụng độ phân giải mặc định 720p
2. Số lượng khung hình: Đảm bảo tổng số khung hình đầu tiên, cuối và trung gian không vượt quá 10
3. Tư liệu tham chiếu: Đảm bảo số lượng và thời lượng tư liệu tham chiếu nằm trong giới hạn được nêu trong tài liệu
4. Âm thanh gốc: Chỉ sử dụng keep_original_sound cho Reference-to-Video hoặc Video Edit
5. Kéo dài video: Đặt duration thành thời lượng cần nối thêm và bỏ qua aspect_ratio