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

Wan 2.6 Reference to Video

alibaba/wan/2.6/reference-to-video

Alibaba Wan 2.6 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.
The URLs of reference videos to guide video generation.
The duration of the generated video in seconds. Valid values are 5 and 10. Allowed values: 5, 10.
The aspect ratio of the generated video. Allowed values: 1:1, 4:3, 3:4, 16:9, 9:16.
The resolution of the video to generate. Allowed values: 720p, 1080p.
Random seed (0-2147483647) for reproducible results. Omit for a random seed.

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

Reference images, referred to in the prompt as Image1, Image2, ... Combined with videos, up to 5 references in total.
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.6/reference-to-video
Execution
async
Base URL
https://api.sandbase.ai
API
Unified Run API
Endpoint
/v1/run

API README

Wan 2.6 Reference to Video

Place characters from reference images or short reference videos into a new scene. Name each reference in the prompt and Wan 2.6 keeps their look while they act out the scene, including multi-character interactions and dialogue.

Fields

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

Billing

You pay for output seconds: $0.10 at 720p and $0.15 at 1080p, 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

Failed runs are not charged.

Prompting

  • Give every reference a role and refer to it by number: “Video 1 plays guitar on the chair from Image 3”.
  • Quote dialogue and name the speaker.

Limits

  • Send at least one image or video reference.

Also on SandBase

Other Wan 2.6 endpoints: alibaba/wan/2.6/text-to-video, alibaba/wan/2.6/image-to-video, alibaba/wan/2.6/flash/image-to-video, alibaba/wan/2.6/flash/reference-to-video, alibaba/wan/2.6/text-to-image, alibaba/wan/2.6/image-to-image, alibaba/wan/2.7/text-to-video (newer).

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.6/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.6/reference-to-video",
  "prompt": "Video1 holds Image2 and plays a soothing country folk song on the chair from Image3, saying: 'The sunshine is so nice today.' Image1 holds a bouquet of sunflowers, walks past Video1, places the flowers on the table next to Video1, and says: 'That sounds lovely, could you sing it again?'",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}
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 / runDec 16, 2025
AlibabaVideo$0.50 / runOct 5, 2026
AlibabaVideo$0.50 / runOct 5, 2026
AlibabaVideo$1.40 / runOct 4, 2026
AlibabaVideo$0.70 / runOct 4, 2026
AlibabaVideo$1.00 / runOct 4, 2026

Questions

FAQ

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

Create a SandBase API key, then send requests with the model ID "alibaba/wan/2.6/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.6 Reference to Video and the other models in the catalog; you do not need to sign up with Alibaba separately.