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 ID mô hình wan-2-2-animate-replace, đầu vào được hỗ trợ, tham số, quy tắc Files API, tín dụng và ví dụ phản hồi.
Khả dụng qua APIĐầu vào URL sẵn sàngVideo
ID mô hình API
wan-2-2-animate-replace
Đầu vào
url
Files API
Không bắt buộc cho yêu cầu tối thiểu
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
Quy ước yêu cầu
Gửi ID mô hình ở cấp trên cùng. Điều khiển riêng của mô hình nằm trong params.
| Key | Loại | Bắt buộc | Mặc định | Mô tả |
|---|---|---|---|---|
| model | string | Có | wan-2-2-animate-replace | Dùng wan-2-2-animate-replace làm ID mô hình API. |
| prompt | string | Không | - | Văn bản prompt cho mô hình hỗ trợ đầu vào văn bản. |
| params | object | Không | - | Đối tượng 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 | - | ID phía client không bắt buộc để theo dõi yêu cầu trong hệ thống của bạn. |
Tham số mô hình
| Key | Loại | Bắt buộc | Mặc định | Phạm vi | Tùy chọn | 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
Điểm cuối tạo trả về ID tác vụ công khai. Hãy thăm dò điểm cuối trạng thái cho đến khi tác vụ 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 đầu vào URL công khai qua tham số mô hình.