R2V means reference-to-video. Reference images guide identity and appearance; they are not treated as the first frame.
Key capabilities
- Multi-image reference - Supply 1 to 9 images
- Reference-aware prompts - Address each image with
[Image 1],[Image 2], and so on - Synchronized audio - Generate audio with the video
- Resolution -
720Por1080P - Duration - An integer from 3 to 15 seconds
- Aspect ratio control - Nine supported landscape, portrait, square, and ultra-wide ratios
Reference image requirements
- Formats: JPEG, JPG, PNG, or WEBP
- Input: public HTTP/HTTPS URL or Base64 data URL
- Count: 1 to 9 images
- Resolution: shortest side at least 400 pixels; 720P or clearer is recommended
- File size: up to 20 MB per image
Quick example
cURL
Parameters
API Reference
View the request and response schema.
Task Query
Poll task status and retrieve the result URL.