Dokumentasi 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 disokong, parameter, peraturan Files API, kredit dan contoh respons.

Tersedia melalui APIKesediaanVideo
ID model API

wan-2-2-animate-replace

Input

file

Files API

Diperlukan untuk mod rujukan

Kredit asas

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

Keupayaan

Video

Bil

METERED

Had prompt

Tiada had prompt didokumenkan

Kontrak permintaan

Hantar ID model pada peringkat atas. Kawalan khusus model berada dalam params.

KunciJenisWajibLalaiPenerangan
modelstringYawan-2-2-animate-replaceGunakan ID model API wan-2-2-animate-replace.
promptstringYa-Teks prompt untuk model yang menyokong input teks.
paramsobjectTidak-Objek parameter khusus model. Gunakan baris di bawah untuk kunci yang dibenarkan.
client_request_idstringTidak-ID sisi klien pilihan untuk menjejak permintaan dalam sistem anda.

Parameter model

KunciJenisWajibLalaiJulatPilihanPenerangan
resolutionselectTidak480p-480p, 580p, 720pPeringkat semasa ialah `480p`, `580p`, dan `720p`. Peringkat hasil lebih tinggi biasanya bermaksud kos kredit lebih tinggi dan masa menunggu lebih panjang.

Polisi muat naik

Muat naik fail rujukan dahulu, kemudian letakkan URL dan token durasi yang dikembalikan dalam params.referenceMediaItems.

Peraturan rujukan

video: video, image

Fail maksimum

2

Jenis fail diterima

video, image

Token durasi

Rujukan video dan audio patut membawa durationToken daripada /api/v1/files apabila pengesahan durasi diperlukan.

kindSaiz maksimumJenis MIME
video50 MBvideo/mp4, video/quicktime, video/webm
image10 MBimage/jpeg, image/png, image/webp

Permintaan minimum

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

Permintaan fail rujukan

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

Respons cipta

Endpoint cipta mengembalikan ID tugasan awam. Semak endpoint status sehingga tugasan berjaya 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
}

Ralat biasa

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Sesetengah mod memerlukan muat naik rujukan Files API.