Dùng Kling 4.0 API: chế độ, khung hình chính, tham chiếu, chỉnh sửa

Để dùng Kling 4.0 API, hãy tạo một khóa API, POST một thân JSON với ID mô hình kling-4-0 và prompt của bạn, rồi truy vấn tác vụ được trả về cho tới khi URL video sẵn sàng. Cùng một endpoint bao trọn 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. Media bạn gửi và một trường, omni_reference_task_type, quyết định chế độ nào chạy.

Hướng dẫn này đi qua từng chế độ với thân yêu cầu chạy được vào ngày 22 tháng 10 năm 2026, rồi trình bày cách tính phí từng chế độ và những yêu cầu bị từ chối trước khi bất cứ điều gì bị tính.

Cần chuẩn bị gì trước yêu cầu đầu tiên?

1. Một khóa API. Tạo khóa trên trang khóa API và giữ nó trên máy chủ của bạn. Đừng bao giờ đặt nó trong code chạy trên trình duyệt.
2. Tín dụng. Nạp số dư trên trang thanh toán. Tín dụng không bao giờ hết hạn, và tác vụ thất bại không bị tính phí.
3. ID mô hình kling-4-0.

export SEEDROUTER_API_KEY="your-key"

Gửi yêu cầu Kling 4.0 thế nào?

POST tác vụ tới /v1/videos/generations:

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

Phản hồi là một tác vụ, không phải video:

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

Mọi trường trừ model và, trong hầu hết chế độ, prompt đều có giá trị mặc định:

Không có tùy chọn âm thanh: mỗi clip Kling 4.0 đều có track stereo. Cũng không có trường mode, negative_prompt hay watermark. Lược đồ là nghiêm ngặt, nên một trường không xác định bị từ chối với HTTP 400 trước khi tác vụ được tạo và một lỗi gõ sai không bao giờ biến thành clip có tính phí với thiết lập bị lặng lẽ bỏ qua.

Lấy video bằng cách nào?

Truy vấn GET /v1/tasks/{id} 10–20 giây một lần cho đến khi status là completed hoặc failed. Năm lần chạy thử của chúng tôi mất từ 2 phút 41 giây đến 4 phút 22 giây cho clip 720p dài 3 giây, nên hãy dự kiến vài phút chứ không phải vài giây.

import os
import time
import requests

API = "https://api.seedrouter.ai/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['SEEDROUTER_API_KEY']}"}

task = requests.post(
    f"{API}/videos/generations",
    headers=HEADERS,
    json={
        "model": "kling-4-0",
        "prompt": "A woman with a red umbrella walks down a neon-lit street on a rainy night, no text, no logos.",
        "duration": 5,
    },
    timeout=60,
)
task.raise_for_status()
task_id = task.json()["id"]

while True:
    result = requests.get(f"{API}/tasks/{task_id}", headers=HEADERS, timeout=60).json()
    if result["status"] in ("completed", "failed"):
        break
    time.sleep(15)

if result["status"] == "completed":
    print(result["output"]["video_url"])
else:
    print(result["error"])

Một tác vụ hoàn tất trông như thế này:

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

Đây là clip mà yêu cầu đầu tiên trên trang này tạo ra, dài 5 giây ở 720p:

Kling 4.0, text thành video, 720p, 5 giây, có âm thanh stereo.

Clip 720p của chúng tôi trả về dưới dạng MP4 (H.264) ở 1280 × 720 với track AAC stereo. Tải tệp vào bộ nhớ của riêng bạn: liên kết lưu trữ không phải vĩnh viễn. Hết thời gian mạng khi truy vấn không có nghĩa tạo không thành công, nên hãy giữ ID tác vụ và kiểm tra lại thay vì gửi tác vụ mới.

Chế độ nào chạy yêu cầu Kling 4.0?

Media trong thân chọn chế độ. omni_reference_task_type làm nó rõ ràng nơi media một mình sẽ mơ hồ:

Khung hình và media tham chiếu không thể trộn trong một yêu cầu, và video_url không có edit hay extend bị từ chối. Cả hai đều trả về HTTP 400 trước khi tác vụ tồn tại.

Đặt khung hình chính trong Kling 4.0 thế nào?

Gửi image_with_roles, danh sách các đối tượng {url, role}. Đúng một first_frame, tùy chọn last_frame và tối đa 8 mục keyframe, 10 ảnh tổng cộng. Khung hình chính được dùng theo thứ tự bạn liệt kê, nên danh sách là dòng thời gian.

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

Chỉ cho phép bắt đầu và kết thúc, image_urls: [first, last] ngắn hơn. Image thành video là chế độ duy nhất nơi prompt có thể bị bỏ qua; clip lấy hình dạng của khung đầu.

Dùng ảnh, video và audio tham chiếu thế nào?

Thêm video_urls (tối đa 5 clip, tổng cộng 30 giây), audio_urls (tối đa 3 clip mỗi clip 5–30 giây) và ảnh tham chiếu, tối đa 15 tệp tổng cộng. Nêu chúng trong prompt dưới dạng @Image1, @Video1 và @Audio1, đánh số từ 1 trong mỗi danh sách:

{
  "model": "kling-4-0",
  "prompt": "The woman from @Image1 walks along the deck of the sailboat from @Video1 at sunset",
  "image_with_roles": [{"url": "https://example.com/woman.png", "role": "reference_image"}],
  "video_urls": ["https://example.com/boat.mp4"],
  "aspect_ratio": "auto",
  "duration": 5
}

Ảnh tham chiếu cũng có thể vào image_urls, nhưng chỉ với omni_reference_task_type: "reference"; không có nó, image_urls được đọc dưới dạng khung đầu và khung cuối. Âm thanh của một video tham chiếu được thay thế theo mặc định; đặt audio_setting: "origin" để giữ nó.

Chỉnh sửa video bằng Kling 4.0 thế nào?

Đặt omni_reference_task_type thành edit, truyền video trong video_url, và mô tả thay đổi. Tối đa 10 ảnh tham chiếu có thể vào image_urls.

{
  "model": "kling-4-0",
  "prompt": "Change the scene to a snowy winter evening with falling snow",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/in.mp4"
}

Đầu vào phải ít nhất 3 giây và chỉ 30 giây đầu tiên được dùng. Bỏ qua duration và kết quả theo độ dài video đầu vào; âm thanh gốc được giữ trừ khi bạn đặt audio_setting: "auto".

Kéo dài video bằng cách nào?

Đặt omni_reference_task_type thành extend, truyền video, và cho duration là độ dài phần mới. Kling 4.0 tiếp tục từ khung cuối và trả về bản gốc cộng với các giây mới dưới dạng một tệp. Trong thử nghiệm của chúng tôi, clip dài 5,2 giây kéo dài thêm 3 giây trả về dài 8,1 giây.

{
  "model": "kling-4-0",
  "prompt": "The sailboat keeps gliding forward as the sun sets below the horizon",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/in.mp4",
  "duration": 3
}

Thêm last_frame_image để chọn nơi phần mới kết thúc. Kéo dài giữ tỷ lệ và âm thanh của đầu vào, nên aspect_ratio và audio_setting bị từ chối.

Yêu cầu Kling 4.0 có giá bao nhiêu?

Kling 4.0 được tính phí theo giây video ở mức giá do độ phân giải quyết định. Các giây được tính phí phụ thuộc vào chế độ:

Đầu vào là tổng độ 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, nên số tiền dự trữ là số tiền được tính. Trong thử nghiệm chỉnh sửa của chúng tôi, đầu vào 5,2 giây và kết quả 3 giây tính phí 3 + 6 = 9 giây. Đây là mức giá hiện tại:

Video không thể đọc được chiều dài bị từ chối trước khi bất cứ điều gì bị tính, và tác vụ thất bại không bị tính phí.

Những yêu cầu nào bị từ chối trước khi bất cứ điều gì bị tính?

Chúng trả về HTTP 400 khi gửi, không có tác vụ được tạo và không bị tính:

Tác vụ được chấp nhận rồi không thành công, ví dụ như chính sách nội dung của mô hình, trả về status: "failed" với mã error và không bị tính phí. Danh mục lỗi liệt kê các mã.

Agent mã hóa có thể chạy nó cho bạn không?

Có. Trang Kling 4.0 có prompt sẵn sàng cho Claude Code, Codex hay Cursor mà đọc khóa từ môi trường của bạn, hiển thị yêu cầu và chi phí của nó, chờ phê duyệt của bạn, rồi gửi, truy vấn và tải clip. Cùng trang có playground gửi thân chính xác code của bạn sẽ gửi, với mọi trường được nhóm theo chế độ.

Câu hỏi Kling 4.0 API

Kling 4.0 API có miễn phí không?

Không. Nó được tính phí theo giây video. Tài khoản SeedRouter mới nhận được một khoản tín dụng nhỏ để thử, không có gói đăng ký, và tác vụ thất bại không bị tính phí.

Kling 4.0 Flash có trong API không?

Chưa. Kling 4.0 Flash là một mô hình riêng biệt, nhẹ hơn trong cùng một gia đình; Kling liệt kê nó với clip 720p ngắn hơn và không có nhiều khung hình chính.^[1] ID mô hình kling-4-0 là Kling 4.0 đầy đủ.

Kling 4.0 khác Kling 3.0 ở điểm nào trong API?

Kling 4.0 tạo clip tới 30 giây, lấy khung hình chính, video và audio tham chiếu, và có thể chỉnh sửa hay kéo dài video; âm thanh luôn bật. Kling 3.0 tạo clip 3–15 giây, cung cấp 4K, prompt đa cảnh quay và chủ thể đặt tên, và có tùy chọn âm thanh. Hướng dẫn API Kling 3.0 bao trọn các trường của nó. Kling công bố 4.0 với độ dài 30 giây, 10 khung hình chính và âm thanh stereo vào ngày 30 tháng 9 năm 2026.^[2]

Tôi có thể hủy tác vụ không?

Không. Sau khi được chấp nhận, tác vụ chạy cho đến hoàn thành hoặc thất bại. Tác vụ thất bại không bị tính phí.

Tài liệu tham khảo

1. Kling AI. Kling 4.0 video generation (tổng quan tính năng và câu hỏi thường gặp). Kiểm tra ngày 8 tháng 10 năm 2026 từ kling.ai.
2. Kling AI. Introducing Kling 4.0: Visual Realism, Creative Control, and Next-Level Storytelling. Ngày 30 tháng 9 năm 2026. Kiểm tra ngày 8 tháng 10 năm 2026 từ kling.ai.