Alibaba modelsvideo generation api

alibaba/wan/2.7/reference-to-video

Alibaba Wan 2.7 reference-to-video model generating video guided by reference content.

Input
The text prompt to generate a video from.

PNG, JPEG, WebP, or GIF · 20 MiB maximum each

The URLs of reference images to guide video generation. Provide at least one reference image or video.
The URLs of reference videos to guide video generation.
The URLs of reference audio files to guide video generation.
The duration of the generated video in seconds. Allowed values: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15.
The aspect ratio of the generated video. Allowed values: 16:9, 9:16, 1:1, 4:3, 3:4.
The resolution of the video to generate. Allowed values: 720p, 1080p.
Idle

Example output — click Run to generate your own

API README

Wan 2.7 Reference to Video

Wan 2.7 Reference to Video creates a new video under the guidance of supplied visual references and a written scene description. It is intended for work where the generated sequence should draw from existing subjects or visual material rather than begin from text alone. Reference images establish the visual anchors while the prompt directs the action and scene.

The route accepts a prompt and reference images as its required creative inputs. Optional media fields can carry additional guidance under the local request contract. The result is a newly generated clip rather than a conventional edit of the input media.

Highlights

  • Enhanced motion smoothness. Wan 2.7 is documented with improved motion smoothness. The reference-guided route applies that family capability to a newly generated sequence.
  • Superior scene fidelity. The exact Wan 2.7 route highlights stronger fidelity to the generated scene. This helps the resulting video retain a coherent visual treatment.
  • Greater visual coherence. Wan 2.7 is designed to keep the generated visuals connected over time. That capability is especially relevant when references anchor subjects or visual material.
  • Multi-character interactions. The exact reference-to-video route supports scenes where multiple referenced characters perform and interact. This extends reference guidance beyond a single subject.

Pricing

DurationResolutionPrice
2 seconds720p$0.20
2 seconds1080p$0.30
3 seconds720p$0.30
3 seconds1080p$0.45
4 seconds720p$0.40
4 seconds1080p$0.60
5 seconds720p$0.50
5 seconds1080p$0.75
6 seconds720p$0.60
6 seconds1080p$0.90
7 seconds720p$0.70
7 seconds1080p$1.05
8 seconds720p$0.80
8 seconds1080p$1.20
9 seconds720p$0.90
9 seconds1080p$1.35
10 seconds720p$1.00
10 seconds1080p$1.50
11 seconds720p$1.10
11 seconds1080p$1.65
12 seconds720p$1.20
12 seconds1080p$1.80
13 seconds720p$1.30
13 seconds1080p$1.95
14 seconds720p$1.40
14 seconds1080p$2.10
15 seconds720p$1.50
15 seconds1080p$2.25

When to Use

✅ Good fit❌ Consider alternatives
Generating a new clip around a referenced subjectStarting from text with no visual reference
Carrying visual material from one or more images into a sceneMaking a deterministic frame-by-frame edit
Using existing footage as optional generation guidanceUpscaling an unchanged video
Building a short sequence from a written action briefRequiring a clip longer than 15 seconds in one request
Adding an audio reference when it should guide generationRequiring a silent-only pipeline with no media guidance

Prompt Guide

Use the prompt to describe what should happen in the newly generated clip, while the media arrays identify the reference material. Name the subject action, setting, camera behavior, and progression over time.

Referenced subject/material: [what to carry from the inputs]
Action: [movement over time]
Setting: [environment]
Camera: [framing and movement]
Progression: [beginning to ending state]
{
  "images": ["https://example.com/character-reference.png"],
  "prompt": "The referenced character walks through a windswept meadow at sunset as the camera tracks alongside, ending on a medium close-up.",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}

Technical Specs

SpecValue
Model IDalibaba/wan/2.7/reference-to-video
Required inputsprompt and images
Reference mediaImage array; optional video and audio arrays
DurationInteger 2 through 15 seconds; default 5
Resolution720p or 1080p; default 720p
Aspect ratio16:9, 9:16, 1:1, 4:3, or 3:4
OutputVideo URL and content type
ExecutionAsynchronous job

Related

Related Models