Wan 3.0 Video modelini Rivya Public API v1 üzerinden model id wan-3-0-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-3-0-video

Girişler

text, file

Files API

Referans modları için gerekli

Temel krediler

per_input_and_output_second · standard_480P=8 · standard_720P=16 · standard_1080P=32 · prime_480P=12.2 · prime_720P=25.2 · prime_1080P=50.4 · ⌈total⌉

Yetenek

Video

Faturalandırma

METERED

Prompt limiti

20000 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-3-0-video	wan-3-0-video API model kimliği değerini kullanın.
prompt	string	Evet	-	Bu model için en fazla 20000 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
seedance_scene	select	Hayır	text	-	text, frames, reference	Medya yüklemeden önce birbirini dışlayan bir girdi sözleşmesi seçin.
variant	select	Hayır	standard	-	standard, prime	Standard ve Prime aynı denetimleri ancak farklı saniye başı oranları kullanır.
resolution	select	Hayır	1080P	-	480P, 720P, 1080P	Rezervasyon, sürüm ve çözünürlük ücretinin doğrulanmış giriş videosu saniyeleri ile rezerve edilen çıkış saniyelerinin toplamıyla çarpılmasıdır; toplam bir kez yukarı yuvarlanır. Akıllı süre 30 çıkış saniyesi ayırır ve referans videoyla kullanılamaz.
aspect_ratio	select	Hayır	adaptive	-	adaptive, 16:9, 4:3, 1:1, 3:4, 9:16	Uyarlanabilir kadraj veya tek bir sabit çıktı oranı seçin.
duration	number	Hayır	5	min -1 / max 30 / step 1	-	Akıllı süre için -1 veya 2–30 saniye arasında bir tam sayı seçin. Akıllı süre 30 çıktı saniyesi ayırır ve referans videosuyla kullanılamaz.
audio	select	Hayır	true	-	true, false	Üretilen videonun model tarafından oluşturulan ses içerip içermeyeceğini seçin.
seed	number	Hayır	-	min 0 / max 2147483647 / step 1	-	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ı

Kılavuz kareler veya imzalı çok modlu referanslar: Kareler sahnesi zorunlu bir ilk görüntü ve isteğe bağlı bir son görüntü kabul eder. Referans sahnesi her biri 20 MB olan en fazla 10 JPEG, saydam olmayan PNG, WebP veya BMP görüntü; her biri 95 MB ve 1–15 saniye olan 5 MP4/MOV video; her biri 15 MB ve 1–15 saniye olan 5 MP3/WAV ses klibi kabul eder. Video ve ses toplamlarının her biri 15 saniyeyle sınırlıdır.

Maks. dosya

Kabul edilen dosya türleri

image, video, audio

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	20 MB	image/jpeg, image/png, image/bmp, image/webp
video	95 MB	video/mp4, video/quicktime
audio	15 MB	audio/mpeg, audio/wav, audio/x-wav

Minimal istek

{
  "model": "wan-3-0-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "text",
    "variant": "standard",
    "resolution": "1080P",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "audio": "true",
    "seed": 0
  }
}

Referans dosyalı istek

{
  "model": "wan-3-0-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "reference",
    "variant": "standard",
    "resolution": "1080P",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "audio": "true",
    "seed": 0,
    "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"
      }
    ]
  }
}

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_3_0_video_example",
  "status": "queued",
  "model": "wan-3-0-video",
  "reserved_credits": 160,
  "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 3.0 Video API Entegrasyonu