Kling 3.0 motion-control modelini Rivya Public API v1 üzerinden model id kling-3-0-motion-control, desteklenen girişler, parametreler, Files API kuralları, krediler ve yanıt örnekleriyle kullanın.

API üzerinden kullanılabilirHazırlıkVideo

API model kimliği

kling-3-0-motion-control

Girişler

file

Files API

Referans modları için gerekli

Temel krediler

Kredi oranı: 20–27 / çıktı saniyesi Görevin son maliyeti tam krediye yukarı yuvarlanır.

Yetenek

Video

Faturalandırma

METERED

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-3-0-motion-control	kling-3-0-motion-control API model kimliği değerini kullanın.
prompt	string	Hayır	-	Bu model için en fazla 2500 karakter.
params	object	Evet	-	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
mode	select	Hayır	720p	-	720p, 1080p	Üretim modu
character_orientation	select	Hayır	video	-	video, image	Karakter yönünün hareket videosuna mı yoksa referans görsele mi daha yakın kalacağını kontrol eder.

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örsel + hareket videosu: Tam 1 görsel + 1 hareket videosu projesi kimlik ve hareket rollerini net tutar Standard (720P): 20 × doğrulanmış hareket videosu saniyesi; Pro (1080P): 27 × saniye

Maks. dosya

Kabul edilen dosya türleri

image, video

Süre belirteci

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
video	95 MB	video/mp4, video/quicktime

Bu model için çalıştırılabilir Public API örneği gösterilmiyor.

Referans dosyalı istek

{
  "model": "kling-3-0-motion-control",
  "params": {
    "mode": "720p",
    "character_orientation": "video",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      },
      {
        "url": "https://cdn.example.com/reference-video.mp4",
        "kind": "video",
        "name": "reference-video.mp4",
        "mimeType": "video/mp4",
        "durationSeconds": 8,
        "durationToken": "video_duration_token_from_files_api",
        "width": 1280,
        "height": 720,
        "sizeBytes": 8388608,
        "framesPerSecond": 30,
        "videoBitrateMbps": 8,
        "videoMetadataToken": "video_metadata_token_from_original_files_api_upload_response"
      }
    ]
  }
}

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_3_0_motion_control_example",
  "status": "queued",
  "model": "kling-3-0-motion-control",
  "reserved_credits": 27,
  "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
}

Yaygın hatalar

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Bazı modlar Files API referans yüklemeleri gerektirir.

Kling 3.0 motion-control API Entegrasyonu