{"servers":[{"url":"https://api.modellix.ai/api/v1/alibaba/wan2.7-r2v"}],"post":{"description":"[Core Function] Wan 2.7 Reference-to-Video is a highly capable character/entity reference video model. [Strengths] It natively supports entity reference, voice customization, and playbook-based video generation from a single storyboard. [Best For] Highly recommended for: creating consistent video series, brand mascot animation, and storyboard-driven storytelling. [Limitations] Do NOT use this model for simple, single-image direct animation (use I2V instead). [Routing] Use this by default for complex character consistency and storyboard generation tasks on Alibaba.","operationId":"wan27R2vAsync","requestBody":{"content":{"application/json":{"examples":{"advanced":{"summary":"Multiple references with settings","value":{"duration":5,"negative_prompt":"blurry, distorted","prompt":"Characters interact in a vibrant scene","prompt_extend":true,"ratio":"9:16","reference_images":["https://example.com/char1.jpg","https://example.com/char2.jpg"],"reference_videos":["https://example.com/action.mp4"],"resolution":"1080P","seed":42}},"basic":{"summary":"Basic video generation with one image","value":{"prompt":"The character walks through a blooming garden in spring","reference_images":["https://example.com/character.jpg"]}},"first_frame":{"summary":"With first frame specification","value":{"duration":8,"first_frame_image":"https://example.com/first_frame.jpg","prompt":"A character dancing in the rain","reference_images":["https://example.com/character.jpg"]}},"mixed_media":{"summary":"Mixed media with prompt referencing","value":{"duration":10,"prompt":"Video2 holding Image3 playing a soothing country tune in a cafe, Video1 watching Video2 with a smile","ratio":"16:9","reference_images":["https://example.com/image3.jpg"],"reference_videos":["https://example.com/video1.mp4","https://example.com/video2.mp4"],"resolution":"720P"}}},"schema":{"description":"At least one of reference_images, reference_videos, or first_frame_image must be provided.","properties":{"duration":{"default":5,"description":"Video duration in seconds. Dynamic range: [2,10] when reference_videos is present, [2,15] when only reference_images","enum":[2,3,4,5,6,7,8,9,10,11,12,13,14,15],"example":5,"type":"integer"},"first_frame_image":{"description":"First frame image URL. At least one media parameter (reference_images, reference_videos, or first_frame_image) must be provided. Max 1, not counted in the 5-item limit","example":"https://example.com/first_frame.jpg","format":"uri","type":"string"},"negative_prompt":{"description":"Negative prompt describing unwanted content","example":"blurry, distorted, low quality","maxLength":500,"type":"string"},"prompt":{"description":"Video content description (supports Chinese and English, up to 5000 characters). Can reference media using 'Image1/Image2' or 'Video1/Video2' format","example":"The character walks through a blooming garden","maxLength":5000,"minLength":1,"type":"string"},"prompt_extend":{"default":true,"description":"Enable intelligent prompt rewriting","example":true,"type":"boolean"},"ratio":{"default":"16:9","description":"Video aspect ratio (auto-ignored when first_frame_image is present)","enum":["16:9","9:16","1:1","4:3","3:4"],"example":"16:9","type":"string"},"reference_images":{"description":"Reference image URLs. At least one media parameter (reference_images, reference_videos, or first_frame_image) must be provided. Combined with reference_videos, max 5 total","example":["https://example.com/char1.jpg","https://example.com/char2.jpg"],"items":{"example":"https://example.com/character.jpg","format":"uri","type":"string"},"type":"array"},"reference_videos":{"description":"Reference video URLs. At least one media parameter (reference_images, reference_videos, or first_frame_image) must be provided. Combined with reference_images, max 5 total","example":["https://example.com/action.mp4"],"items":{"example":"https://example.com/action.mp4","format":"uri","type":"string"},"type":"array"},"resolution":{"default":"1080P","description":"Video resolution tier","enum":["720P","1080P"],"example":"1080P","type":"string"},"seed":{"description":"Random seed for reproducibility","example":42,"maximum":2147483647,"minimum":0,"type":"integer"}},"required":["prompt"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"code":{"description":"Response code, 0 indicates success","example":0,"type":"integer"},"data":{"description":"Detailed data about the submitted asynchronous task.","properties":{"get_result":{"description":"API information to query the task result","properties":{"method":{"description":"HTTP method","example":"GET","type":"string"},"url":{"description":"Full URL to query the task result","example":"https://api.modellix.ai/api/v1/tasks/task-abc123","type":"string"}},"type":"object"},"model_id":{"description":"Model ID","example":"model-123","type":"string"},"status":{"description":"Task status","enum":["pending","processing"],"example":"pending","type":"string"},"task_id":{"description":"Unique task identifier","example":"task-abc123","type":"string"}},"required":["status","task_id","model_id"],"type":"object"},"message":{"description":"Response message","example":"success","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"Task submitted successfully"}},"summary":"Wan 2.7 Reference-to-Video","x-mint":{"href":"alibaba/wan-2-7-r2v"}}}