Trang API mô hình
Tích hợp API Wan Animate Replace
Dùng Wan Animate Replace qua Rivya Public API v1 với model id wan-2-2-animate-replace, input được hỗ trợ, tham số, quy tắc Files API, tín dụng và ví dụ response.
Khả dụng qua APIURL input sẵn sàngVideo
ID mô hình API
wan-2-2-animate-replace
Input
url
Files API
Không bắt buộc cho minimal request
Tín dụng cơ bản
20
Năng lực
Video
Thanh toán
FIXED
Giới hạn prompt
Không có giới hạn prompt được ghi
Hợp đồng yêu cầu
Gửi model id ở top level. Điều khiển riêng của mô hình nằm trong params.
| Key | Type | Bắt buộc | Default | Mô tả |
|---|---|---|---|---|
| model | string | Có | wan-2-2-animate-replace | Dùng API model id wan-2-2-animate-replace. |
| prompt | string | Không | - | Prompt text cho mô hình hỗ trợ text input. |
| params | object | Không | - | Object tham số riêng của mô hình. Dùng các dòng bên dưới để xem key được phép. |
| client_request_id | string | Không | - | Client-side id tùy chọn để trace request trong hệ thống của bạn. |
Tham số mô hình
| Key | Type | Bắt buộc | Default | Range | Options | Mô tả |
|---|---|---|---|---|---|---|
| video_url | text | Không | - | - | - | Dán một URL video công khai mà dịch vụ tạo có thể fetch trực tiếp. Mô hình này cần asset đã được lưu trữ như MP4, MOV hoặc MKV, không phải đường dẫn upload cục bộ. |
| image_url | text | Không | - | - | - | Dán một URL ảnh thay thế công khai. JPEG, PNG hoặc WebP hoạt động tốt nhất; khi tỷ lệ khung hình khác nhau, dịch vụ upstream sẽ scale và center-crop. |
| resolution | select | Không | 480p | - | 480p, 580p, 720p | Các tầng hiện tại là `480p`, `580p` và `720p`. Tầng đầu ra cao hơn thường đồng nghĩa với chi phí credit cao hơn và thời gian chờ lâu hơn. |
Yêu cầu tối thiểu
{
"model": "wan-2-2-animate-replace",
"params": {
"video_url": "https://example.com/input.mp4",
"image_url": "https://example.com/reference.png",
"resolution": "480p"
}
}Phản hồi tạo
Create endpoint trả về public task id. Poll status endpoint cho đến khi task succeeded hoặc failed.
{
"id": "task_wan_2_2_animate_replace_example",
"status": "queued",
"model": "wan-2-2-animate-replace",
"reserved_credits": 20,
"final_credits": 0,
"created_at": "2026-05-11T00:00:00.000Z",
"updated_at": "2026-05-11T00:00:00.000Z",
"result": null,
"error": null
}Lỗi thường gặp
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Mô hình này nhận public URL input qua model parameters.