Dùng Kling V2.1 Master qua Rivya Public API v1 với model id kling-v2-1-master, input được hỗ trợ, tham số, quy tắc Files API, tín dụng và ví dụ response.

Khả dụng qua APIText hoặc URL sẵn sàng; reference modes dùng Files APIVideo

ID mô hình API

kling-v2-1-master

Input

text, file

Files API

Bắt buộc cho reference modes

Tín dụng cơ bản

160

Năng lực

Video

Thanh toán

FIXED

Giới hạn prompt

5000 ký tự

Hợp đồng yêu cầu

Gửi model id ở top level. Điều khiển riêng của mô hình nằm trong params.

Key	Type	Bắt buộc	Default	Mô tả
model	string	Có	kling-v2-1-master	Dùng API model id kling-v2-1-master.
prompt	string	Có	-	Tối đa 5000 ký tự cho mô hình này.
params	object	Không	-	Object tham số riêng của mô hình. Dùng các dòng bên dưới để xem key được phép.
client_request_id	string	Không	-	Client-side id tùy chọn để trace request trong hệ thống của bạn.

Tham số mô hình

Key	Type	Bắt buộc	Default	Range	Options	Mô tả
duration	select	Không	5	-	5, 10	Thời lượng
aspect_ratio	select	Không	16:9	-	16:9, 9:16, 1:1	Tỷ lệ khung hình
negative_prompt	text	Không	-	-	-	Prompt phủ định
cfg_scale	number	Không	0.5	min 0 / max 1	-	Kiểm soát mức kết quả bám theo prompt. Giá trị cao thường bám prompt hơn, nhưng cũng có thể khiến chuyển động hoặc bố cục cứng hơn.

Chính sách tải lên

Upload reference files trước, rồi đặt URL và duration token được trả về vào params.referenceMediaItems.

Quy tắc tham chiếu

Ảnh tham chiếu: Tùy chọn tải lên một ảnh để chuyển sang chế độ chuyển ảnh thành video; để trống để ở chế độ văn bản.

Số file tối đa

Loại file được chấp nhận

image

Token thời lượng

Tham chiếu video và audio nên mang durationToken từ /api/v1/files khi cần xác minh duration.

kind	Kích thước tối đa	MIME types
image	10 MB	image/jpeg, image/png, image/webp

Yêu cầu tối thiểu

{
  "model": "kling-v2-1-master",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Mô tả những gì video nên tránh",
    "cfg_scale": 0.5
  }
}

Yêu cầu có tệp tham chiếu

{
  "model": "kling-v2-1-master",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Mô tả những gì video nên tránh",
    "cfg_scale": 0.5,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Phản hồi tạo

Create endpoint trả về public task id. Poll status endpoint cho đến khi task succeeded hoặc failed.

{
  "id": "task_kling_v2_1_master_example",
  "status": "queued",
  "model": "kling-v2-1-master",
  "reserved_credits": 160,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Một số mode cần Files API reference uploads.

Tích hợp API Kling V2.1 Master