Kling 3.0 API: cách dùng với khóa, yêu cầu và kết quả

Để dùng Kling 3.0 API, hãy tạo một khóa API, POST một thân JSON với ID mô hình kling-3-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. Một endpoint bao trọn văn bản thành video, video từ khung hình đầu và cuối, clip nhiều cảnh quay và tham chiếu chủ thể; các trường trong thân yêu cầu quyết định dùng kiểu nào.

Hướng dẫn này đi qua từng bước với code chạy được, rồi trình bày khung hình, clip nhiều cảnh quay, chủ thể và những yêu cầu bị từ chối trước khi bị tính bất kỳ khoản phí nào.

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

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.
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í.
ID mô hình kling-3-0.

export SEEDROUTER_API_KEY="your-key"

Gửi yêu cầu Kling 3.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-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": "std",
    "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-3-0", "status": "processing", "created_at": 1789689600}

Mọi trường trừ model và prompt đều có giá trị mặc định:

Trường	Mặc định	Giá trị
`mode`	`pro`	`std` (720p), `pro` (1080p), `4K`
`duration`	`5`	3–15 giây
`aspect_ratio`	`16:9`	`16:9`, `9:16`, `1:1`
`sound`	`false`	`true` tạo âm thanh gốc

Lược đồ là nghiêm ngặ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, nên một lỗi gõ sai không bao giờ biến thành một clip phải trả tiền mà 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. Trong thử nghiệm của chúng tôi, một clip std dài 3 giây xong trong khoảng hai phút, còn một clip pro dài 5 giây có âm thanh mất khoảng hai phút rưỡi.

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-3-0",
        "prompt": "A red paper boat drifting on a calm pond at sunrise, slow push-in, no text, no logos.",
        "mode": "std",
        "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ư sau:

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

std trả về ở 1280 × 720 và pro ở 1920 × 1080, đều là MP4 (H.264); khi bật sound, tệp có rãnh âm thanh stereo. Hãy tải tệp về kho lưu trữ của riêng bạn: liên kết lưu trữ không tồn tại vĩnh viễn. 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, nên hãy giữ ID tác vụ và kiểm tra lại thay vì gửi một tác vụ mới.

Bắt đầu từ khung hình đầu và cuối thế nào?

Truyền một hoặc hai URL ảnh trong image_urls. Ảnh thứ nhất mở đầu clip; ảnh thứ hai là nơi clip kết thúc. Không có ảnh thì clip được tạo chỉ từ prompt.

{
  "model": "kling-3-0",
  "prompt": "The camera glides from the empty street to the lit shop window",
  "image_urls": ["https://example.com/start.png", "https://example.com/end.png"],
  "mode": "pro",
  "duration": 6
}

Ảnh phải là URL HTTP(S) công khai, định dạng JPG hoặc PNG. Dữ liệu base64 bị từ chối; hãy tải tệp lên kho lưu trữ của bạn trước.

Tạo clip nhiều cảnh quay thế nào?

Đặt multi_shots thành true và mô tả từng cảnh quay trong multi_prompt, tối đa năm cảnh quay, mỗi cảnh 1–12 giây. Tổng thời lượng các cảnh quay phải từ 3–15 giây, và tổng đó là độ dài clip bạn bị tính phí; duration không được dùng.

{
  "model": "kling-3-0",
  "mode": "pro",
  "sound": true,
  "multi_shots": true,
  "multi_prompt": [
    {"prompt": "Wide shot of a small open kitchen, a chef tosses vegetables in a wok, flames rising, warm light.", "duration": 3},
    {"prompt": "Close-up of the wok, vegetables flipping through the flames, oil sizzling, steam drifting.", "duration": 3}
  ]
}

Đây là clip mà yêu cầu trên tạo ra trong thử nghiệm của chúng tôi, một video 6 giây cắt từ cảnh toàn sang cận cảnh:

Kling 3.0, pro (1080p), nhiều cảnh quay 3 + 3 giây, có âm thanh.

Giữ một người hoặc sản phẩm nhất quán thế nào?

Thêm nó vào kling_elements: một name, một description ngắn và 2–4 URL ảnh của đối tượng, tối đa ba chủ thể mỗi yêu cầu. Nhắc tên chủ thể trong prompt.

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

Những yêu cầu nào bị từ chối trước khi tính phí?

Những yêu cầu này trả về HTTP 400 ngay khi gửi, không tạo tác vụ và không tính phí:

Yêu cầu	Lý do
Clip nhiều cảnh quay có tổng các cảnh quay dưới 3 hoặc trên 15 giây	Kling 3.0 tạo clip dài 3–15 giây
Chủ thể không có `description`	Chủ thể nào cũng cần trường này
Hơn 2 `image_urls`, hơn 5 cảnh quay hoặc hơn 3 chủ thể	Vượt giới hạn của mô hình
`mode: "4k"` viết thường	Giá trị đúng là `4K`
Ảnh base64, hoặc bất kỳ trường nào không có trong bảng trên	Media được truyền dưới dạng URL; lược đồ là nghiêm ngặt

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

Cách này khác gì API riêng của Kling?

API dành cho nhà phát triển của Kling dùng tên trường riêng, và phiên bản cũ khác với phiên bản hiện tại.^[1]^[2] Nếu bạn chuyển một tích hợp sang, hãy ánh xạ các trường:

SeedRouter	API cũ của Kling
`model: "kling-3-0"`	`model_name: "kling-v3"`
`sound: true` / `false`	`sound: "on"` / `"off"`
`duration: 5` (số nguyên)	`duration: "5"` (chuỗi)
`mode: "4K"`	`mode: "4k"`
`image_urls: [first, last]`	`image` và `image_tail`
`multi_shots` + `multi_prompt: [{prompt, duration}]`	`multi_shot` + `shot_type: "customize"` + `multi_prompt: [{index, prompt, duration}]`
`kling_elements: [{name, description, element_input_urls}]`	`element_list: [{element_id}]`, tạo trước

SeedRouter giao kết quả qua một tác vụ để bạn truy vấn; không hỗ trợ callback_url.

Coding agent có chạy thay bạn được không?

Có. Trang Kling 3.0 có sẵn một prompt cho Claude Code, Codex hoặc Cursor: agent đọc khóa từ biến môi trường, cho bạn xem yêu cầu và chi phí, chờ bạn duyệt, rồi gửi, truy vấn và tải clip về. Cùng trang đó có một playground gửi đúng phần thân mà code của bạn sẽ gửi.

Kling AI. Kling 3.0: Text to Video (tài liệu API, phiên bản cũ). Truy cập ngày 6 tháng 10 năm 2026 từ kling.ai.
Kling AI. Kling 3.0: Image to Video (tài liệu API, phiên bản cũ). Truy cập ngày 6 tháng 10 năm 2026 từ kling.ai.
Kling AI. Pricing: Video (API cho nhà phát triển). Truy cập ngày 6 tháng 10 năm 2026 từ kling.ai.

Cách dùng Kling 3.0 API: khóa, yêu cầu, truy vấn tác vụ, khung hình và nhiều cảnh quay

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

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

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

Bắt đầu từ khung hình đầu và cuối thế nào?

Tạo clip nhiều cảnh quay thế nào?

Giữ một người hoặc sản phẩm nhất quán thế nào?

Những yêu cầu nào bị từ chối trước khi tính phí?

Cách này khác gì API riêng của Kling?

Coding agent có chạy thay bạn được không?

Câu hỏi về Kling 3.0 API

Kling 3.0 có API chính thức không?

Kling 3.0 API giá bao nhiêu?

Có hủy được tác vụ Kling 3.0 không?

Tài liệu tham khảo

Hướng dẫn liên quan

Giá Kling 3.0 API: chi phí mỗi giây ở 720p, 1080p và 4K, có và không có âm thanh

Hướng dẫn viết prompt Kling 3.0: chuyển động máy quay, cảnh nhiều cảnh quay, lời thoại và nhân vật nhất quán

Giá API Nano Banana 2.1: chi phí mỗi ảnh ở 1K, 2K và 4K, và cách gọi API