Gunakan Kling V2.1 Pro melalui Rivya Public API v1 dengan id model kling-v2-1-pro, input yang didukung, parameter, aturan Files API, kredit, dan contoh response.

Tersedia via APIKesiapanVideo

ID model API

kling-v2-1-pro

Input

file

Files API

Diperlukan untuk mode referensi

Kredit dasar

per_video · 5s=50 · 10s=100 · ⌈total⌉

Kapabilitas

Video

Tagihan

FIXED

Batas prompt

5000 karakter

Kontrak request

Kirim id model di level atas. Kontrol khusus model berada di params.

Key	Tipe	Wajib	Default	Deskripsi
model	string	Ya	kling-v2-1-pro	Gunakan kling-v2-1-pro sebagai id model API.
prompt	string	Ya	-	Maksimum 5000 karakter untuk model ini.
params	object	Tidak	-	Objek parameter khusus model. Gunakan baris di bawah untuk key yang diizinkan.
client_request_id	string	Tidak	-	ID sisi klien opsional untuk melacak request di sistem Anda.

Parameter model

Key	Tipe	Wajib	Default	Rentang	Opsi	Deskripsi
duration	select	Tidak	5	-	5, 10	Durasi
negative_prompt	text	Tidak	-	-	-	Prompt negatif
cfg_scale	number	Tidak	0.5	min 0 / max 1 / step 0.1	-	Mengontrol seberapa ketat hasil mengikuti prompt Anda. Nilai yang lebih tinggi biasanya lebih dekat ke prompt, tetapi juga dapat membuat gerakan atau komposisi terasa lebih kaku.

Kebijakan unggahan

Unggah file referensi terlebih dahulu, lalu tempatkan URL dan duration token yang dikembalikan ke dalam params.referenceMediaItems.

Aturan referensi

Gambar referensi: Mode gambar menerima hingga 2 file gambar, dan gambar kedua dipetakan ke frame akhir. JPEG/PNG ≤ 10 MB.

File maksimum

Jenis file yang diterima

image

Duration token

Referensi video dan audio harus membawa durationToken dari /api/v1/files saat verifikasi durasi diperlukan.

kind	Ukuran maksimum	Tipe MIME
image	10 MB	image/jpeg, image/png

Request minimal

{
  "model": "kling-v2-1-pro",
  "params": {
    "duration": "5",
    "negative_prompt": "Jelaskan apa yang harus dihindari video",
    "cfg_scale": 0.5
  }
}

Request file referensi

{
  "model": "kling-v2-1-pro",
  "params": {
    "duration": "5",
    "negative_prompt": "Jelaskan apa yang harus dihindari video",
    "cfg_scale": 0.5,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Response create

Endpoint create mengembalikan public task id. Poll endpoint status sampai tugas berhasil atau gagal.

{
  "id": "task_kling_v2_1_pro_example",
  "status": "queued",
  "model": "kling-v2-1-pro",
  "reserved_credits": 50,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Error umum

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Beberapa mode membutuhkan unggahan referensi Files API.

Integrasi API Kling V2.1 Pro