R2V means reference-to-video. Reference assets define appearance and identity; an optional first_frame can separately control the opening frame.
Key capabilities
- Mixed references - Combine reference images and videos, up to 5 assets in total
- First-frame control - Add at most one
first_frame - Voice reference - Attach
reference_voiceto a reference image or video - Prompt references - Refer to assets as
Image 1,Image 2,Video 1, andVideo 2 - Resolution -
720Por1080P - Duration - 2-10 seconds when a reference video is used; otherwise 2-15 seconds
- Output - 30 fps MP4 video
Quick example
cURL
Enable NSFW generation
- Select the
Special-Nsresource group when creating the API token. - Set
parameters.prompt_extendtofalse. Its default value istrue.
Input limits
- Reference image: JPEG/JPG/PNG/BMP/WEBP, 240-8,000 px per side, aspect ratio 1:8 to 8:1, up to 20 MB; URL or Base64 data URL
- Reference video: MP4/MOV, 1-30 seconds, 240-4,096 px per side, aspect ratio 1:8 to 8:1, up to 100 MB; public URL
- Reference voice: WAV/MP3, 1-10 seconds, up to 15 MB; public URL
- Asset count: at least one reference image or video; reference images plus reference videos must not exceed 5
Parameters
API Reference
View the complete request schema.
Task Query
Poll the task and retrieve the result URL.