Wan 2.5 Video modelini Rivya Public API v1 üzerinden model id wan-2-5-video, 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 kimliği

wan-2-5-video

Girişler

text, file

Files API

Referans modları için gerekli

Temel krediler

per_video · 720p_5=60 · 720p_10=120 · 1080p_5=100 · 1080p_10=200 · ⌈total⌉

Yetenek

Video

Faturalandırma

FIXED

Prompt limiti

800 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	wan-2-5-video	wan-2-5-video API model kimliği değerini kullanın.
prompt	string	Evet	-	Bu model için en fazla 800 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
resolution	select	Hayır	720p	-	720p, 1080p	Çözünürlük
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ı
enable_prompt_expansion	select	Hayır	false	-	false, true	Çünkü Wan 2.5 zaten oldukça yönlendirilmiş kısa klipler içindir. Aynı çekimin varyasyonlarını karşılaştırırken seed daha tekrarlanabilir bir seçeneğe yakın kalmanıza yardım eder, negatif prompt yaygın hata türlerini kaldırmaya yardım eder ve prompt genişletme birebir kalmak mı yoksa modelin ayrıntı eklemesine izin vermek mi istediğinizi belirler. Klip yalnızca 5 veya 10 saniye olsa bile yön zaten belirgin olduğunda bu kombinasyon faydalıdır.
seed	number	Hayır	-	min 0 / max 2147483647	-	Her seferinde yeni bir rastgele sonuç için boş bırakın. Aynı tam sayıyı yeniden kullanmak, önceki bir sonucu yeniden üretmeyi veya ince ayar yapmayı kolaylaştırır. Yalnızca istem ve diğer temel ayarlar da benzer kaldığında sonuca daha yakın durur; bire bir eşleşme garanti değildir.
negative_prompt	text	Hayır	-	-	-	Negatif prompt

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: Görselden videoya modu için en fazla 1 görsel dosyası yükleyin.

Maks. dosya

Kabul edilen dosya türleri

image

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

Minimal istek

{
  "model": "wan-2-5-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "negative_prompt": "Kaçınılacak isteğe bağlı dışlamalar veya hata türleri."
  }
}

Referans dosyalı istek

{
  "model": "wan-2-5-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "negative_prompt": "Kaçınılacak isteğe bağlı dışlamalar veya hata türleri.",
    "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_wan_2_5_video_example",
  "status": "queued",
  "model": "wan-2-5-video",
  "reserved_credits": 60,
  "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.

Wan 2.5 Video API Entegrasyonu