Docs Rivya AI
Halaman API model

Integrasi API Kling V2.5 Turbo Pro

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

Tersedia melalui APITeks atau URL sedia; mod rujukan menggunakan Files APIVideo
ID model API

kling-v2-5-turbo-pro

Input

text, file

Files API

Diperlukan untuk mod rujukan

Kredit asas

42

Keupayaan

Video

Bil

FIXED

Had prompt

2500 aksara

Kontrak permintaan

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

KunciJenisWajibLalaiPenerangan
modelstringYakling-v2-5-turbo-proGunakan ID model API kling-v2-5-turbo-pro.
promptstringYa-Maksimum 2500 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
aspect_ratioselectTidak16:9-16:9, 9:16, 1:1Nisbah aspek
negative_prompttextTidak---Prompt negatif
cfg_scalenumberTidak0.5min 0 / max 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: Muat naik sehingga 2 imej secara pilihan untuk beralih ke mod imej-ke-video; imej kedua dipetakan kepada bingkai hujung.

Fail maksimum

2

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, image/webp

Permintaan minimum

{
  "model": "kling-v2-5-turbo-pro",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Terangkan perkara yang patut dielakkan dalam video",
    "cfg_scale": 0.5
  }
}

Permintaan fail rujukan

{
  "model": "kling-v2-5-turbo-pro",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "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. Poll endpoint status sehingga tugasan berjaya atau gagal.

{
  "id": "task_kling_v2_5_turbo_pro_example",
  "status": "queued",
  "model": "kling-v2-5-turbo-pro",
  "reserved_credits": 42,
  "final_credits": 0,
  "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.