Dokumentasi Rivya AI
Halaman API model

Integrasi API Kling V2.1 Standard

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

Tersedia melalui APIKesediaanVideo
ID model API

kling-v2-1-standard

Input

file

Files API

Diperlukan untuk mod rujukan

Kredit asas

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

Keupayaan

Video

Bil

FIXED

Had prompt

5000 aksara

Kontrak permintaan

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

KunciJenisWajibLalaiPenerangan
modelstringYakling-v2-1-standardGunakan ID model API kling-v2-1-standard.
promptstringYa-Maksimum 5000 aksara untuk model ini.
paramsobjectTidak-Objek parameter khusus model. Gunakan baris di bawah untuk kunci yang dibenarkan.
client_request_idstringTidak-ID sisi klien pilihan untuk menjejak permintaan dalam sistem anda.

Parameter model

KunciJenisWajibLalaiJulatPilihanPenerangan
durationselectTidak5-5, 10Tempoh
negative_prompttextTidak---Prompt negatif
cfg_scalenumberTidak0.5min 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 1 fail imej sebagai bingkai pertama. JPEG/PNG ≤ 10 MB.

Fail maksimum

1

Jenis fail diterima

image

Token durasi

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

kindSaiz maksimumJenis MIME
image10 MBimage/jpeg, image/png

Permintaan minimum

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

Permintaan fail rujukan

{
  "model": "kling-v2-1-standard",
  "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_standard_example",
  "status": "queued",
  "model": "kling-v2-1-standard",
  "reserved_credits": 25,
  "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.