Kling V2.5 Turbo Pro modelini Rivya Public API v1 üzerinden model id kling-v2-5-turbo-pro, desteklenen girişler, parametreler, Files API kuralları, krediler ve yanıt örnekleriyle kullanın.

API üzerinden kullanılabilirMetin veya URL hazır; referans modları Files API kullanırVideo

API model id

kling-v2-5-turbo-pro

Girişler

text, file

Files API

Referans modları için gerekli

Temel krediler

Yetenek

Video

Faturalandırma

FIXED

Prompt limiti

2500 karakter

İstek sözleşmesi

Model id değerini en üst seviyede gönderin. Modele özel kontroller params içine aittir.

Anahtar	Tür	Gerekli	Varsayılan	Açıklama
model	string	Evet	kling-v2-5-turbo-pro	kling-v2-5-turbo-pro API model id değerini kullanın.
prompt	string	Evet	-	Bu model için en fazla 2500 karakter.
params	object	Hayır	-	Modele özel parametre nesnesi. İzin verilen anahtarlar için aşağıdaki satırları kullanın.
client_request_id	string	Hayır	-	Sisteminizde istekleri izlemek için isteğe bağlı istemci tarafı id.

Model parametreleri

Anahtar	Tür	Gerekli	Varsayılan	Aralık	Seçenekler	Açıklama
duration	select	Hayır	5	-	5, 10	Süre
aspect_ratio	select	Hayır	16:9	-	16:9, 9:16, 1:1	En-boy oranı
negative_prompt	text	Hayır	-	-	-	Negatif istem
cfg_scale	number	Hayır	0.5	min 0 / max 1	-	Sonucun isteminizi ne kadar sıkı izleyeceğini kontrol eder. Daha yüksek değerler genellikle isteme daha yakın kalır, ancak hareketi veya kompozisyonu daha katı hissettirebilir.

Yükleme politikası

Önce referans dosyalarını yükleyin, ardından dönen URLyi ve duration token değerini params.referenceMediaItems içine yerleştirin.

Referans kuralı

Referans görseller: Görselden videoya moda geçmek için isteğe bağlı olarak en fazla 2 görsel yükleyin; ikinci görsel son kareye eşlenir.

Maks. dosya

Kabul edilen dosya türleri

image

Duration token

Süre doğrulaması gerektiğinde video ve ses referansları /api/v1/files içinden durationToken taşımalıdır.

kind	Maks. boyut	MIME türleri
image	10 MB	image/jpeg, image/png, image/webp

Minimal istek

{
  "model": "kling-v2-5-turbo-pro",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Videonun kaçınması gerekenleri açıklayın",
    "cfg_scale": 0.5
  }
}

Referans dosyalı istek

{
  "model": "kling-v2-5-turbo-pro",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Videonun kaçınması gerekenleri açıklayın",
    "cfg_scale": 0.5,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Create yanıtı

Create endpointi herkese açık task id döndürür. Görev başarılı veya başarısız olana kadar status endpointini sorgulayın.

{
  "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
}

Yaygın hatalar

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Bazı modlar Files API referans yüklemeleri gerektirir.

Kling V2.5 Turbo Pro API Entegrasyonu