Docs Rivya AI
Halaman API Model

Integrasi API Kling V2.1 Master

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

Tersedia via APITeks atau URL siap; mode referensi memakai Files APIVideo
ID model API

kling-v2-1-master

Input

text, file

Files API

Diperlukan untuk mode referensi

Kredit dasar

160

Kapabilitas

Video

Tagihan

FIXED

Batas prompt

5000 karakter

Kontrak request

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

KeyTipeWajibDefaultDeskripsi
modelstringYakling-v2-1-masterGunakan kling-v2-1-master sebagai id model API.
promptstringYa-Maksimum 5000 karakter untuk model ini.
paramsobjectTidak-Objek parameter khusus model. Gunakan baris di bawah untuk key yang diizinkan.
client_request_idstringTidak-ID sisi klien opsional untuk melacak request di sistem Anda.

Parameter model

KeyTipeWajibDefaultRentangOpsiDeskripsi
durationselectTidak5-5, 10Durasi
aspect_ratioselectTidak16:9-16:9, 9:16, 1:1Rasio aspek
negative_prompttextTidak---Prompt negatif
cfg_scalenumberTidak0.5min 0 / max 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: Opsional unggah satu gambar untuk beralih ke mode gambar-ke-video; biarkan kosong agar tetap di mode teks.

File maksimum

1

Jenis file yang diterima

image

Duration token

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

kindUkuran maksimumTipe MIME
image10 MBimage/jpeg, image/png, image/webp

Request minimal

{
  "model": "kling-v2-1-master",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Jelaskan apa yang harus dihindari video",
    "cfg_scale": 0.5
  }
}

Request file referensi

{
  "model": "kling-v2-1-master",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "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_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
}

Error umum

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Beberapa mode membutuhkan unggahan referensi Files API.