API Free WeekHundreds of APIs are free to call this week.Browse free APIs

Wan 2.7 Reference to Video

alibaba/wan/2.7/reference-to-video

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

Base price
$0.50USD / run
Execution
async
Model type
video
Input fields
7
Production route

Try the model

Playground

Open playground
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 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.
Random seed (0-2147483647) for reproducible results. Omit for a random seed.
OutputExample

Examples

Select an example to load its inputs and result into the playground.

Model card

Specifications

Pricing

Base price
$0.50 / run

Context & modalities

Input
Schema-defined
Output
video

Capabilities

Chat
Not supported
Vision
Not supported
Reasoning
Not supported
Structured output
Not supported
Function calling
Not supported
Audio input
Not supported

Access

Provider
Alibaba
Model ID
alibaba/wan/2.7/reference-to-video
Execution
async
Base URL
https://api.sandbase.ai
API
Unified Run API
Endpoint
/v1/run

API README

Wan 2.7 Reference to Video

Cast people, products, or characters from reference images (and optional reference videos) into a new scene. The prompt directs what they do; Wan 2.7 keeps their appearance consistent and supports several referenced characters interacting in one shot.

Fields

FieldTypeDefaultNotes
promptstring, required—Up to 50,000 characters.
imagesimage URL[], required—Reference images, referred to in the prompt as Image 1, Image 2, …
videosvideo URL[]—Optional reference clips, referred to as Video 1, Video 2, …
duration2–155Output length in seconds.
aspect_ratio16:9 / 9:16 / 1:1 / 4:3 / 3:4—Output frame shape.
resolution720p / 1080p720pSets the per-second rate.
seedintegerrandomFix it to compare prompt changes.

Billing

You pay for output seconds: $0.10 at 720p and $0.15 at 1080p, the same as Alibaba's list price. When you send reference videos, 5 seconds of input are added to the billed length.

Output720p1080p
5s, images only$0.50$0.75
5s, with reference video$1.00$1.50
10s, images only$1.00$1.50
15s, images only$1.50$2.25

Failed runs are not charged.

Prompting

  • Give every reference a role: “Image 1 is the chef, Image 2 is the kitchen, Video 1 sets the camera move”.
  • Numbering follows array order, so reordering images changes what “Image 2” means.
  • Keep each reference image to one clear subject.

Limits

  • The output is a new clip; to change an existing video use alibaba/wan/2.7/video-edit.

Also on SandBase

Other Wan 2.7 endpoints: alibaba/wan/2.7/text-to-video, alibaba/wan/2.7/image-to-video, alibaba/wan/2.7/video-edit, alibaba/wan/2.7/video-extend, alibaba/wan/3.0/video (newer, up to 30s).

Start building

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

Production API
Unified Run API endpoint
https://api.sandbase.ai/v1/run
Model ID
alibaba/wan/2.7/reference-to-video
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "model": "alibaba/wan/2.7/reference-to-video",
  "images": [
    "https://static.sandbase.ai/examples/alibaba/wan/2.6/reference-to-video/flash/input_images_0.png"
  ],
  "prompt": "A golden retriever puppy running through a field of wildflowers in slow motion, ears flapping, tongue out, soft backlight",
  "duration": 5,
  "resolution": "720p"
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
  status=$(printf '%s' "$result" | jq -r .status)
  case "$status" in completed|failed|timeout) break ;; esac
  sleep 2
  result=$(curl --fail-with-body --silent \
    -H "Authorization: Bearer $SANDBASE_API_KEY" \
    "https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"

Choose your model

Compare models

All image & video models
ModelTypeDefault priceReleased
AlibabaVideo$0.50 / runMar 28, 2026
AlibabaVideo$1.40 / runOct 4, 2026
AlibabaVideo$2.80 / runOct 4, 2026
AlibabaVideo$1.00 / runOct 4, 2026
AlibabaVideo$2.00 / runOct 4, 2026
AlibabaVideo$0.70 / runAug 24, 2026

Questions

FAQ

How do I call Alibaba Wan 2.7 Reference to Video through SandBase?

Create a SandBase API key, then send requests with the model ID "alibaba/wan/2.7/reference-to-video" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.

Do I need a separate Alibaba account?

No. One SandBase API key and balance gives you access to Alibaba Wan 2.7 Reference to Video and the other models in the catalog; you do not need to sign up with Alibaba separately.