> ## Documentation Index > Fetch the complete documentation index at: https://docs.modellix.ai/llms.txt > Use this file to discover all available pages before exploring further. # Wan 2.7 Reference-to-Video > [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. ## OpenAPI ````yaml /model-api/alibaba/alibaba-v2v.json post /alibaba/wan2.7-r2v openapi: 3.1.0 info: description: The video-to-video models API from Alibaba. version: 1.0.0 contact: name: Modellix Support email: support@modellix.ai title: Alibaba Video-to-Video Models API servers: - url: https://api.modellix.ai/api/v1 description: The video-to-video models API from Alibaba. security: - bearerAuth: [] paths: /alibaba/wan2.7-r2v: post: summary: Wan 2.7 Reference-to-Video 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: required: true content: application/json: schema: $ref: '#/components/schemas/Wan27R2vRequest' examples: 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 mixed_media: summary: Mixed media with prompt referencing value: prompt: >- Video2 holding Image3 playing a soothing country tune in a cafe, Video1 watching Video2 with a smile reference_videos: - https://example.com/video1.mp4 - https://example.com/video2.mp4 reference_images: - https://example.com/image3.jpg resolution: 720P ratio: '16:9' duration: 10 first_frame: summary: With first frame specification value: prompt: A character dancing in the rain reference_images: - https://example.com/character.jpg first_frame_image: https://example.com/first_frame.jpg duration: 8 advanced: summary: Multiple references with settings value: prompt: Characters interact in a vibrant scene reference_images: - https://example.com/char1.jpg - https://example.com/char2.jpg reference_videos: - https://example.com/action.mp4 negative_prompt: blurry, distorted resolution: 1080P ratio: '9:16' duration: 5 prompt_extend: true seed: 42 responses: '200': description: Task submitted successfully content: application/json: schema: $ref: '#/components/schemas/AsyncTaskResponse' components: schemas: Wan27R2vRequest: type: object description: >- At least one of reference_images, reference_videos, or first_frame_image must be provided. required: - prompt properties: prompt: type: string description: >- Video content description (supports Chinese and English, up to 5000 characters). Can reference media using 'Image1/Image2' or 'Video1/Video2' format minLength: 1 maxLength: 5000 example: The character walks through a blooming garden reference_images: type: array 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 items: type: string format: uri example: https://example.com/character.jpg example: - https://example.com/char1.jpg - https://example.com/char2.jpg reference_videos: type: array 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 items: type: string format: uri example: https://example.com/action.mp4 example: - https://example.com/action.mp4 first_frame_image: type: string format: uri 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 negative_prompt: type: string description: Negative prompt describing unwanted content maxLength: 500 example: blurry, distorted, low quality resolution: type: string description: Video resolution tier enum: - 720P - 1080P default: 1080P example: 1080P ratio: type: string description: Video aspect ratio (auto-ignored when first_frame_image is present) enum: - '16:9' - '9:16' - '1:1' - '4:3' - '3:4' default: '16:9' example: '16:9' duration: type: integer 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 default: 5 example: 5 prompt_extend: type: boolean description: Enable intelligent prompt rewriting default: true example: true seed: type: integer description: Random seed for reproducibility minimum: 0 maximum: 2147483647 example: 42 AsyncTaskResponse: type: object required: - code - message - data properties: code: type: integer description: Response code, 0 indicates success example: 0 message: type: string description: Response message example: success data: type: object required: - status - task_id - model_id properties: status: type: string enum: - pending - processing description: Task status example: pending task_id: type: string description: Unique task identifier example: task-abc123 model_id: type: string description: Model ID example: model-123 get_result: type: object description: API information to query the task result properties: method: type: string description: HTTP method example: GET url: type: string description: Full URL to query the task result example: https://api.modellix.ai/api/v1/tasks/task-abc123 description: Detailed data about the submitted asynchronous task. securitySchemes: bearerAuth: type: http scheme: bearer description: 'API Key authentication. Format: `Bearer YOUR_API_KEY`.' ````