Kling 3.0 API

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

Các Phiên Bản Mô Hình

API này hỗ trợ bốn phiên bản mô hình:

So Sánh Nhanh

Tỷ Lệ Khung Hình Được Hỗ Trợ

Kling 3.0 Text to Video (Std & Pro)

Endpoint

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

Phiên Bản Std:

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-v3.0-std-text-to-video',
    prompt: 'A fox running through a snowy forest at dusk',
    duration: 5,
    aspect_ratio: '16:9'
  })
});

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

Phiên Bản Pro:

javascriptSao chép
{
  model_name: 'kling-v3.0-pro-text-to-video',
  prompt: 'A fox running through a snowy forest at dusk',
  duration: 5,
  aspect_ratio: '16:9'
}

Kling 3.0 Image to Video (Std & Pro)

Tham Số Yêu Cầu

Bắt Buộc

Tùy Chọn

Ví Dụ Yêu Cầu

Phiên Bản Std:

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-v3.0-std-image-to-video',
    image_url: 'https://example.com/image.jpg',
    prompt: 'Gentle breeze, leaves rustling, slow camera pull back',
    duration: 5,
    aspect_ratio: '16:9'
  })
});

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

Phiên Bản Pro:

javascriptSao chép
{
  model_name: 'kling-v3.0-pro-image-to-video',
  image_url: 'https://example.com/image.jpg',
  prompt: 'Gentle breeze, leaves rustling, slow camera pull back',
  duration: 5,
  aspect_ratio: '16:9'
}

Định Dạng Phản Hồi

Phản Hồi Ban Đầu

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"
  }
}

Phản Hồi Khi Kiểm Tra Trạng Thái

Gọi GET /api/v1/video/{taskId} để kiểm tra trạng thái:

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": "succeed",
    "task_status_msg": null,
    "task_result": {
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Các Giá Trị Trạng Thái

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

Thời Gian Xử Lý

• Phiên Bản Std: khoảng 2-4 phút tùy thuộc vào thời lượng
• Phiên Bản Pro: khoảng 3-6 phút tùy thuộc vào thời lượng

Kiểm tra mỗi 5-10 giây. Các video dài hơn (10-15 giây) có thể mất thêm thời gian.

Các Thực Hành Tốt Nhất

1. Mô Tả Chuyển Động Rõ Ràng: Đưa vào mô tả các chuyển động camera và hành động của đối tượng để có kết quả năng động hơn
2. Sử Dụng Negative Prompt: Loại trừ các yếu tố không mong muốn (ví dụ: "blurry, low quality, watermark") để cải thiện đầu ra
3. Guidance Scale: Giá trị thấp hơn (0.3-0.5) cho phép tự do sáng tạo hơn; giá trị cao hơn (0.7-1.0) tuân theo mô tả chặt chẽ hơn
4. Chất Lượng Hình Ảnh: Với image-to-video, sử dụng hình ảnh đầu vào sắc nét, có ánh sáng tốt để đạt chất lượng chuyển động tốt nhất
5. Thời Lượng: Bắt đầu với thời lượng ngắn hơn (3-5 giây) để lặp lại nhanh, sau đó tăng lên cho đầu ra cuối cùng
6. Lựa Chọn Cấp Độ: Sử dụng Std để lặp lại nhanh hơn và Pro cho các video chất lượng sản xuất cuối cùng