Kling 3.0

Kling 3.0 là mô hình tạo video của Kuaishou. Một yêu cầu tạo một clip 3–15 giây từ prompt, hoặc từ khung hình đầu và một khung hình cuối không bắt buộc, ở ba chế độ chất lượng (std, pro, 4K), có âm thanh gốc khi bạn yêu cầu. Một clip cũng có thể là chuỗi tối đa năm cảnh quay, mỗi cảnh có prompt và độ dài riêng. Hãy gửi yêu cầu, giữ ID tác vụ được trả về, rồi đọc video hoàn chỉnh từ tác vụ. Ảnh được truyền vào dưới dạng URL.

ID mô hình

Xem trang mô hình để biết giá hiện tại.

Ví dụ nhanh

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3-0",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist on the water, slow push-in, no text, no logos.",
    "mode": "pro",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

Endpoint

POST https://api.seedrouter.ai/v1/videos/generations

Phản hồi là một tác vụ ({"id": "task_...", "status": "processing"}), không phải video hoàn chỉnh. Hãy truy vấn GET /v1/tasks/{task_id} để lấy kết quả. Hãy giữ khóa API trong code phía máy chủ.

Tham số

Lược đồ là nghiêm ngặt: trường không xác định bị từ chối chứ không bị bỏ qua. callback_url không được hỗ trợ; hãy truy vấn tác vụ thay thế.

Clip nhiều cảnh quay

Đặt multi_shots thành true và mô tả từng cảnh quay trong multi_prompt. Tổng thời lượng các cảnh quay phải từ 3–15 giây; tổng đó là độ dài clip, và duration không được dùng. Có thể bỏ prompt, hoặc dùng nó cho phần mọi cảnh quay đều có chung.

{
  "model": "kling-3-0",
  "mode": "pro",
  "multi_shots": true,
  "multi_prompt": [
    {"prompt": "A red paper boat on a calm pond at sunrise, wide shot", "duration": 3},
    {"prompt": "The boat drifts under a small wooden bridge, low angle", "duration": 3}
  ]
}

Chủ thể

Chủ thể là đối tượng mà mô hình giữ nhất quán suốt clip: một người, một sản phẩm hoặc một nhân vật. Hãy đặt cho nó một name, một description ngắn và 2–4 ảnh, rồi nhắc tên nó trong prompt (ví dụ @hero).

{
  "model": "kling-3-0",
  "prompt": "@hero slowly turns toward the camera in soft window light",
  "kling_elements": [
    {
      "name": "hero",
      "description": "a young woman with short black hair and a yellow raincoat",
      "element_input_urls": ["https://example.com/hero-front.png", "https://example.com/hero-side.png"]
    }
  ]
}

Đầu vào media

Mọi ảnh đều là URL HTTP(S) công khai. Không chấp nhận data URI base64: hãy tải tệp lên kho lưu trữ của bạn và truyền URL của nó. Dùng ảnh JPG hoặc PNG tối đa 10 MB.

Các yếu tố chi phí

Xem phần giá của mô hình để biết mức giá hiện tại. Kling 3.0 tính phí theo từng giây video, với mức giá do chế độ và việc bật sound quyết định:

billed seconds = duration                      (single shot)
billed seconds = Σ multi_prompt[].duration     (multi_shots: true)
cost = billed seconds × rate per second

Số giây tính phí được biết ngay khi yêu cầu được tiếp nhận, nên số tiền tạm giữ chính là số tiền bị tính. Xem khoản phí cuối cùng trong lịch sử sử dụng của tài khoản. Tác vụ thất bại không bị tính phí.

Lược đồ đầu ra

Khi gửi, API trả về tác vụ:

{"id": "task_...", "model": "kling-3-0", "status": "processing", "created_at": 1789689600}

Lấy thông tin tác vụ

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Hãy truy vấn 10–20 giây một lần cho đến khi status là completed hoặc failed. Hết thời gian mạng trong lúc truy vấn không có nghĩa là việc tạo video đã thất bại: hãy giữ ID tác vụ và tiếp tục kiểm tra. Đừng tạo tác vụ khác chỉ để xem tiến độ.

Tác vụ hoàn tất

{
  "id": "task_...",
  "model": "kling-3-0",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689710,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

Trong thử nghiệm của chúng tôi, một clip std dài 3 giây trả về dạng MP4 (H.264) ở 1280 × 720, còn một clip pro dài 5 giây có sound trả về ở 1920 × 1080 kèm rãnh âm thanh, mỗi clip mất khoảng hai đến ba phút.

Lỗi

Những yêu cầu bị từ chối trước khi tác vụ được tạo sẽ trả về lỗi HTTP kèm đối tượng error và không bị tính phí. Tác vụ thất bại sau khi đã được tiếp nhận sẽ trả về HTTP 200 khi truy vấn, kèm status: "failed" và một đối tượng error.

Hãy xem danh mục lỗi dùng chung để biết mã lỗi, mã trạng thái HTTP và hướng dẫn thử lại.

{
  "id": "task_...",
  "model": "kling-3-0",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Nếu chính lần gửi bị hết thời gian chờ, hãy kiểm tra các tác vụ của bạn trước khi gửi lại: yêu cầu đầu tiên có thể đã được tiếp nhận.

Mẹo

• Mô tả chủ thể, địa điểm, chuyển động máy quay và ánh sáng, mỗi thứ một câu; Kling làm theo ngôn ngữ máy quay như "slow push-in" (máy quay từ từ tiến lại gần) và "low angle" (góc thấp).
• Làm bản nháp ở std, rồi render cảnh quay cuối cùng ở pro hoặc 4K với cùng một yêu cầu.
• Dùng khung hình đầu và khung hình cuối để kiểm soát điểm bắt đầu và kết thúc của cảnh quay.
• Chia một cảnh thành các cảnh quay bằng multi_prompt thay vì mô tả nhiều lần cắt cảnh trong một prompt.
• Thêm no text, no logos để tránh các dấu hiệu tự bịa ra.

Liên quan

• Kling 3.0 Playground và bảng giá
• Tải OpenAPI
• Markdown có thể sao chép