Video
Kling 4.0
Tạo clip Kling 4.0 dài 3–30 giây có âm thanh stereo từ text, khung hình chính hoặc ảnh, video và audio tham chiếu, hoặc chỉnh sửa và kéo dài video, ở 720p hoặc 1080p.
Kling 4.0 là mô hình video mà Kuaishou công bố vào tháng 9 năm 2026. Một ID mô hình phủ năm chế độ: text thành video, image thành video với tối đa 10 khung hình, tạo theo tham chiếu từ ảnh, video và audio, chỉnh sửa video, và kéo dài video. Mỗi clip dài 3–30 giây ở 720p hoặc 1080p với âm thanh stereo. 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
| ID mô hình | Chế độ | Độ phân giải | Độ dài |
|---|---|---|---|
kling-4-0 | text, image, reference, edit, extend | 720p, 1080p | 3–30 giây |
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-4-0",
"prompt": "A woman with a red umbrella walks down a neon-lit street on a rainy night, signs shimmering in the puddles, the camera tracking low beside her. No text, no logos.",
"resolution": "720p",
"duration": 5,
"aspect_ratio": "16:9"
}'Điểm cuối
POST https://api.seedrouter.ai/v1/videos/generations| Header | Giá trị |
|---|---|
| Authorization | Bearer YOUR_API_KEY |
| Content-Type | application/json |
Phản hồi là một tác vụ ({"id": "task_...", "status": "processing"}), không phải video hoàn chỉnh. Truy vấn GET /v1/tasks/{task_id} để lấy kết quả. Giữ API key trong mã phía máy chủ.
Tham số
| Trường | Loại | Mặc định | Ghi chú |
|---|---|---|---|
model | string | bắt buộc | kling-4-0 |
prompt | string | bắt buộc | Tùy chọn cho image thành video. Nêu tham chiếu dưới dạng @Image1, @Video1, @Audio1, đánh số từ 1 trong mỗi danh sách. |
duration | integer | 5 | 3–30 giây. chỉnh sửa: bỏ qua, đầu ra theo video đầu vào. kéo dài: độ dài phần mới. |
resolution | enum | 720p | 720p hoặc 1080p. |
aspect_ratio | enum | theo chế độ | 16:9, 9:16, 1:1, 21:9; auto cho chỉ chế độ reference. Mặc định: text 16:9, image là hình dạng khung đầu, reference auto, edit là hình dạng video đầu vào. Không chấp nhận kèm extend. |
image_urls | URL list | không | Image thành video: tối đa 2, khung đầu rồi khung cuối. tham chiếu (với omni_reference_task_type: "reference") và edit: tối đa 10 ảnh tham chiếu. |
image_with_roles | object list | không | {"url", "role"} với role first_frame, last_frame, keyframe (hay middle_frame) hoặc reference_image. Đúng 1 khung đầu, tối đa 8 khung hình chính được dùng theo thứ tự, 10 khung tổng cộng. |
first_frame_image | URL | không | Khung đầu cho image thành video. |
last_frame_image | URL | không | Khung cuối cho image thành video, hoặc khung cuối mục tiêu cho extend. |
video_urls | URL list | không | Video tham chiếu: tối đa 5, tổng cộng 30 giây. Cho edit hay extend, đúng 1 thay cho video_url. |
video_url | URL | không | Video đầu vào cho edit hay extend; yêu cầu omni_reference_task_type là edit hoặc extend. |
audio_urls | URL list | không | Audio tham chiếu: tối đa 3 đoạn mỗi đoạn 5–30 giây. |
omni_reference_task_type | enum | auto | auto, reference, edit hoặc extend. |
audio_setting | enum | theo chế độ | origin giữ audio của video đầu vào, auto tạo lại. chỉnh sửa giữ nó theo mặc định; reference với video tạo lại theo mặc định. Không chấp nhận kèm extend. |
Mỗi clip đi kèm âm thanh stereo; không có tùy chọn âm thanh. Không có trường mode, negative_prompt, watermark hay multi-shot. Schema rất khó: các trường chưa biết bị từ chối thay vì bỏ qua. callback_url không khả dụng; thay vào đó hãy truy vấn tác vụ.
Chế độ
Chế độ theo media bạn gửi và omni_reference_task_type:
| Chế độ | Cách chọn |
|---|---|
| Text thành video | Không có media. |
| Image thành video | Khung đầu, tùy chọn khung cuối và khung hình chính. |
| tham chiếu | video_urls, audio_urls hoặc role reference_image, hoặc omni_reference_task_type: "reference". |
| chỉnh sửa | omni_reference_task_type: "edit" và một video đầu vào. |
| kéo dài | omni_reference_task_type: "extend" và một video đầu vào. |
Khung hình và media tham chiếu không thể trộn trong một yêu cầu. Bên cạnh video tham chiếu hay audio, image_urls chỉ tính là ảnh tham chiếu với omni_reference_task_type: "reference"; dùng role reference_image nếu khác. video_url không có edit hay extend bị từ chối.
Khung hình chính
{
"model": "kling-4-0",
"prompt": "A girl walks from the window to the door, then looks back and smiles",
"image_with_roles": [
{"url": "https://example.com/1.png", "role": "first_frame"},
{"url": "https://example.com/2.png", "role": "keyframe"},
{"url": "https://example.com/3.png", "role": "last_frame"}
],
"duration": 10
}tham chiếu
{
"model": "kling-4-0",
"prompt": "The woman from @Image1 walks along the beach with the camera movement of @Video1",
"image_with_roles": [{"url": "https://example.com/woman.png", "role": "reference_image"}],
"video_urls": ["https://example.com/camera.mp4"],
"aspect_ratio": "auto",
"duration": 5
}chỉnh sửa
{
"model": "kling-4-0",
"prompt": "Change the scene to a snowy winter evening",
"omni_reference_task_type": "edit",
"video_url": "https://example.com/in.mp4"
}Video đầu vào phải ít nhất 3 giây; chỉ 30 giây đầu tiên được dùng. Không có duration, đầu ra theo video đầu vào.
kéo dài
{
"model": "kling-4-0",
"prompt": "The camera keeps moving forward as the sky grows darker",
"omni_reference_task_type": "extend",
"video_url": "https://example.com/in.mp4",
"duration": 5
}kéo dài tiếp tục từ khung cuối của video đầu vào và trả về bản gốc cộng phần mới. Thêm last_frame_image để chọn nơi nó kết thúc.
Media đầu vào
Ảnh, video và audio là URL HTTP(S) công khai. URI dữ liệu Base64 không chấp nhận: tải tệp lên bộ nhớ của riêng bạn và truyền URL của chúng. Ảnh, video và audio cộng lại tối đa 15 tệp tham chiếu.
Chiều kích giá
Xem phần giá mô hình để biết mức giá hiện tại. Kling 4.0 được tính phí theo giây video, ở mức giá do độ phân giải quyết định:
text, image, reference without videos: cost = duration × standard rate
extend: cost = new seconds × standard rate
edit, reference with videos: cost = (output + max(output, input)) × video-input rateinput là tổng chiều dài các video đầu vào, làm tròn lên số nguyên giây và giới hạn ở 30. Nó được đo khi yêu cầu được chấp nhận, vì vậy số tiền dự trữ là số tiền được tính. Video không thể đọc chiều dài bị từ chối trước khi bất cứ điều gì bị tính phí. Ví dụ: chỉnh sửa video 5,2 giây thành kết quả 3 giây tính phí 3 + 6 = 9 giây. Tác vụ không thành công không bị tính phí.
Lược đồ đầu ra
Gửi trả về tác vụ:
{"id": "task_...", "model": "kling-4-0", "status": "processing", "created_at": 1789689600}Lấy tác vụ
GET https://api.seedrouter.ai/v1/tasks/{task_id}Truy vấn mỗi 10–20 giây cho đến khi status là completed hay failed. Hết thời gian mạng khi truy vấn không có nghĩa tạo không thành công: giữ ID tác vụ và tiếp tục kiểm tra nó. Không tạo tác vụ khác để kiểm tra tiến độ.
Tác vụ hoàn chỉnh
{
"id": "task_...",
"model": "kling-4-0",
"status": "completed",
"created_at": 1789689600,
"finished_at": 1789689800,
"output": {
"video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
}
}Trong các kiểm tra của chúng tôi, clip 720p 3 giây trả về dưới dạng MP4 (H.264) ở 1280 × 720 với track AAC stereo, 2 phút 41 giây đến 4 phút 22 giây sau gửi. Video extend 5,2 giây trả về dài 8,1 giây.
Lỗi
Yêu cầu bị từ chối trước khi tác vụ được tạo trả về lỗi HTTP với đối tượng error và không bị tính phí. Tác vụ không thành công sau khi chấp nhận trả về HTTP 200 khi truy vấn, với status: "failed" và đối tượng error.
Xem danh mục lỗi chung để biết các mã, trạng thái HTTP và hướng dẫn thử lại.
{
"id": "task_...",
"model": "kling-4-0",
"status": "failed",
"error": {
"code": 60001,
"message": "The request was rejected by the content policy. Please revise the prompt or input images."
}
}Nếu gửi hết thời gian, kiểm tra tác vụ của bạn trước khi gửi lại: yêu cầu đầu tiên có thể đã được chấp nhận.
Mẹo
- Mô tả chủ đề, địa điểm, chuyển động máy ảnh, ánh sáng và âm thanh; audio của clip theo prompt.
- Nháp ở
720p, sau đó kết xuất cảnh cuối cùng ở1080pvới yêu cầu tương tự. - Cung cấp khung hình chính cho clip dài hơn để cảnh chuyển động nơi bạn muốn.
- Thêm
no text, no logosđể giữ các dấu hiệu được phát minh ra.
