Gunakan Kling V2.1 Pro melalui Rivya Public API v1 dengan ID model kling-v2-1-pro, input disokong, parameter, peraturan Files API, kredit dan contoh respons.

Tersedia melalui APIKesediaanVideo

ID model API

kling-v2-1-pro

Input

file

Files API

Diperlukan untuk mod rujukan

Kredit asas

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

Keupayaan

Video

Bil

FIXED

Had prompt

5000 aksara

Kontrak permintaan

Hantar ID model pada peringkat atas. Kawalan khusus model berada dalam params.

Kunci	Jenis	Wajib	Lalai	Penerangan
model	string	Ya	kling-v2-1-pro	Gunakan ID model API kling-v2-1-pro.
prompt	string	Ya	-	Maksimum 5000 aksara untuk model ini.
params	object	Tidak	-	Objek parameter khusus model. Gunakan baris di bawah untuk kunci yang dibenarkan.
client_request_id	string	Tidak	-	ID sisi klien pilihan untuk menjejak permintaan dalam sistem anda.

Parameter model

Kunci	Jenis	Wajib	Lalai	Julat	Pilihan	Penerangan
duration	select	Tidak	5	-	5, 10	Tempoh
negative_prompt	text	Tidak	-	-	-	Prompt negatif
cfg_scale	number	Tidak	0.5	min 0 / max 1 / step 0.1	-	Mengawal seberapa rapat hasil mengikut prompt anda. Nilai lebih tinggi biasanya kekal lebih dekat dengan prompt, tetapi juga boleh membuat gerakan atau komposisi terasa lebih kaku.

Polisi muat naik

Muat naik fail rujukan dahulu, kemudian letakkan URL dan token durasi yang dikembalikan dalam params.referenceMediaItems.

Peraturan rujukan

Imej rujukan: Mod imej menerima sehingga 2 fail imej, dan imej kedua dipetakan kepada bingkai hujung. JPEG/PNG ≤ 10 MB.

Fail maksimum

Jenis fail diterima

image

Token durasi

Rujukan video dan audio patut membawa durationToken daripada /api/v1/files apabila pengesahan durasi diperlukan.

kind	Saiz maksimum	Jenis MIME
image	10 MB	image/jpeg, image/png

Permintaan minimum

{
  "model": "kling-v2-1-pro",
  "params": {
    "duration": "5",
    "negative_prompt": "Terangkan perkara yang patut dielakkan dalam video",
    "cfg_scale": 0.5
  }
}

Permintaan fail rujukan

{
  "model": "kling-v2-1-pro",
  "params": {
    "duration": "5",
    "negative_prompt": "Terangkan perkara yang patut dielakkan dalam video",
    "cfg_scale": 0.5,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Respons cipta

Endpoint cipta mengembalikan ID tugasan awam. Semak endpoint status sehingga tugasan berjaya 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
}

Ralat biasa

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Sesetengah mod memerlukan muat naik rujukan Files API.

Integrasi API Kling V2.1 Pro