Docs Rivya AI
Halaman API Model

Integrasi API Wan Animate Replace

Gunakan Wan Animate Replace melalui Rivya Public API v1 dengan id model wan-2-2-animate-replace, input yang didukung, parameter, aturan Files API, kredit, dan contoh response.

Tersedia via APIKesiapanVideo
ID model API

wan-2-2-animate-replace

Input

file

Files API

Diperlukan untuk mode referensi

Kredit dasar

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

Kapabilitas

Video

Tagihan

METERED

Batas prompt

Tidak ada batas prompt terdokumentasi

Kontrak request

Kirim id model di level atas. Kontrol khusus model berada di params.

KeyTipeWajibDefaultDeskripsi
modelstringYawan-2-2-animate-replaceGunakan wan-2-2-animate-replace sebagai id model API.
promptstringYa-Teks prompt untuk model yang mendukung input teks.
paramsobjectTidak-Objek parameter khusus model. Gunakan baris di bawah untuk key yang diizinkan.
client_request_idstringTidak-ID sisi klien opsional untuk melacak request di sistem Anda.

Parameter model

KeyTipeWajibDefaultRentangOpsiDeskripsi
resolutionselectTidak480p-480p, 580p, 720pTingkat saat ini adalah `480p`, `580p`, dan `720p`. Tingkat keluaran yang lebih tinggi biasanya berarti biaya kredit lebih tinggi dan waktu tunggu lebih lama.

Kebijakan unggahan

Unggah file referensi terlebih dahulu, lalu tempatkan URL dan duration token yang dikembalikan ke dalam params.referenceMediaItems.

Aturan referensi

video: video, image

File maksimum

2

Jenis file yang diterima

video, image

Duration token

Referensi video dan audio harus membawa durationToken dari /api/v1/files saat verifikasi durasi diperlukan.

kindUkuran maksimumTipe MIME
video50 MBvideo/mp4, video/quicktime, video/webm
image10 MBimage/jpeg, image/png, image/webp

Request minimal

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

Request file referensi

{
  "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"
      }
    ]
  }
}

Response create

Endpoint create mengembalikan public task id. Poll endpoint status sampai tugas berhasil atau gagal.

{
  "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
}

Error umum

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Beberapa mode membutuhkan unggahan referensi Files API.