Wan 2.7 Video modelini Rivya Public API v1 üzerinden model id wan-2-7-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 id

wan-2-7-video

Girişler

text, file

Files API

Referans modları için gerekli

Temel krediler

Yetenek

Video

Faturalandırma

FIXED

Prompt limiti

5000 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-7-video	wan-2-7-video API model id değerini kullanın.
prompt	string	Evet	-	Bu model için en fazla 5000 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, 15	Metin ve görsel çalıştırmaları 5, 10 veya 15 saniye kullanabilir. Video düzenleme şu anda en fazla 10 saniyeye çıkar ve Rivya bu modda daha uzun seçimleri otomatik olarak normalleştirir.
aspect_ratio	select	Hayır	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4	Metinden videoya ve video düzenleme çalıştırmaları bunu doğrudan kullanır. Görselden videoya şu anda ayrı bir en-boy oranı anahtarı açmak yerine yüklenen karenin geometrisini izler.
negative_prompt	text	Hayır	-	-	-	Negatif prompt
prompt_extend	select	Hayır	true	-	true, false	Modelin üretimden önce promptunuzu yeniden yazıp yazmayacağını kontrol eder. Kolaylık için açık tutun veya zaten çok kesin bir promptunuz varsa kapatın.
watermark	select	Hayır	false	-	false, true	Filigran
audio_setting	select	Hayır	auto	-	auto, origin	Video düzenleme yolunda sesin nasıl ele alınacağını kontrol eder. Otomatik, modelin karar vermesine izin verir; Orijinali koru ise kaynak videonun sesini korumaya çalışı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.

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 medya: En fazla 2 varlık yükleyin. Görselden videoya için en fazla 2 görsel veya video düzenleme için 1 video + 1 isteğe bağlı görsel kullanın.

Maks. dosya

Kabul edilen dosya türleri

image, video

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	20 MB	image/jpeg, image/png, image/webp
video	95 MB	video/mp4, video/quicktime

Minimal istek

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

Referans dosyalı istek

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

Wan 2.7 Video API Entegrasyonu