Rivya AI Dokümanları
Model API Sayfaları

Wan Animate Replace API Entegrasyonu

Wan Animate Replace modelini Rivya Public API v1 üzerinden model id wan-2-2-animate-replace, desteklenen girişler, parametreler, Files API kuralları, krediler ve yanıt örnekleriyle kullanın.

API üzerinden kullanılabilirHazırlıkVideo
API model kimliği

wan-2-2-animate-replace

Girişler

file

Files API

Referans modları için gerekli

Temel krediler

per_output_second · 480p=6 · 580p=9.5 · 720p=12.5 · ⌈total⌉

Yetenek

Video

Faturalandırma

METERED

Prompt limiti

Belgelenmiş prompt limiti yok

İstek sözleşmesi

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

AnahtarTürGerekliVarsayılanAçıklama
modelstringEvetwan-2-2-animate-replacewan-2-2-animate-replace API model kimliği değerini kullanın.
promptstringEvet-Metin girişini destekleyen modeller için prompt metni.
paramsobjectHayır-Modele özel parametre nesnesi. İzin verilen anahtarlar için aşağıdaki satırları kullanın.
client_request_idstringHayır-Sisteminizde istekleri izlemek için isteğe bağlı istemci tarafı id.

Model parametreleri

AnahtarTürGerekliVarsayılanAralıkSeçeneklerAçıklama
resolutionselectHayır480p-480p, 580p, 720pMevcut kademeler `480p`, `580p` ve `720p` şeklindedir. Daha yüksek çıktı kademeleri genellikle daha yüksek kredi maliyeti ve daha uzun bekleme anlamına gelir.

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ı

video: video, image

Maks. dosya

2

Kabul edilen dosya türleri

video, image

Süre belirteci

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

kindMaks. boyutMIME türleri
video50 MBvideo/mp4, video/quicktime, video/webm
image10 MBimage/jpeg, image/png, image/webp

Minimal istek

{
  "model": "wan-2-2-animate-replace",
  "params": {
    "resolution": "480p"
  }
}

Referans dosyalı istek

{
  "model": "wan-2-2-animate-replace",
  "params": {
    "resolution": "480p",
    "referenceMediaItems": [
      {
        "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"
      }
    ]
  }
}

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_2_animate_replace_example",
  "status": "queued",
  "model": "wan-2-2-animate-replace",
  "reserved_credits": 6,
  "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.