Parameters
| Name | Description | Type | Required | Enums |
|---|---|---|---|---|
| image_url | Character image URL to replace the video protagonist (HTTP/HTTPS, publicly accessible, no Chinese or non-ASCII characters). Format: JPG/JPEG/PNG/BMP/WEBP. Size: width and height both in [200, 4096] pixels, aspect ratio 1:3 to 3:1. File size: ≤ 5MB. Content requirement: ensure the character in image has similar aspect ratio to the character in reference video for best results | string | Yes | - |
| mode | Model service mode. Options: (1) ‘wan-std’: Standard mode - faster generation, cost-effective, suitable for quick preview and basic character replacement; (2) ‘wan-pro’: Professional mode - higher animation smoothness and better quality, suitable for film post-production and final output | string | Yes | wan-std, wan-pro |
| video_url | Reference video URL with the original character to be replaced (HTTP/HTTPS, publicly accessible, no Chinese or non-ASCII characters). Format: MP4/AVI/MOV. Duration: 2-30 seconds. Size: width and height both in [200, 2048] pixels, aspect ratio 1:3 to 3:1. File size: ≤ 200MB. The model will replace the character in this video while preserving scene, lighting, and color tone. Tip: Higher resolution and frame rate improve output quality | string | Yes | - |
| check_image | Whether to perform image quality detection. When true (default), validates input image quality and content. When false, skips detection for faster processing. Recommended to keep true for production use to ensure best results | boolean | No | true, false |
Pricing
Unit: $/sec
| Dimension | Pricing |
|---|---|
| mode: wan-std | 0.1115 |
| mode: wan-pro | 0.1612 |
