alibaba/wan/2.6/reference-to-video
Alibaba Wan 2.6 reference-to-video model generating video guided by reference content.
Example output — click Run to generate your own
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
https://api.sandbase.ai/v1/runalibaba/wan/2.6/reference-to-videoInput Schema
5 parameters · 1 required · 4 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
prompt | string | Required | The text prompt to generate a video from. · Min length: 3 · Max length: 50000 · Default: "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?'" |
videos | string[] | Optional | The URLs of reference videos to guide video generation. |
duration | integer | Optional | The duration of the generated video in seconds. Valid values are 5 and 10. · Options: 5, 10 · Default: 5 510 |
resolution | string | Optional | The resolution of the video to generate. · Options: 720p, 1080p · Default: "720p" 720p1080p |
aspect_ratio | string | Optional | The aspect ratio of the generated video. · Options: 1:1, 4:3, 3:4, 16:9, 9:16 1:14:33:416:99:16 |
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
Async Workflow
This model uses asynchronous execution. Submit a request and poll for the result.
- Submit — POST to /v1/run, receive an
id - Poll — GET /v1/run/{id} until status is
completed,failed, ortimeout - Retrieve — Read
outputsfrom the completed response
Code Examples
Ready-to-run snippets
# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"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"
}'
# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
-H "Authorization: Bearer YOUR_API_KEY"API README
Wan 2.6 Reference to Video
Wan 2.6 Reference to Video creates new video around referenced people, characters, pets, or objects, using image or video material to retain recognizable appearance and, when present, vocal character. It is built for interactions involving more than one referenced subject rather than simple first-frame animation.
Assign each reference a clear role in the prompt and describe how the characters interact, where the scene occurs, what they say or do, and how the camera follows them. This model is especially useful for recurring casts, branded mascots, dialogue scenes, and narrative content that depends on stable identity across shots.
Highlights
- Multi-character reference synthesis. Places several referenced protagonists into one generated interaction while keeping them distinguishable.
- Appearance and voice carryover. Extracts visual identity and available vocal traits from reference media for the new performance.
- Narrative shot construction. Supports directed scene progression instead of limiting the output to a single static action.
- Cross-modal character grounding. Uses both image and video references to anchor people, cartoons, animals, or props in the generated world.
Pricing
| Configuration | Billing unit | Price |
|---|---|---|
| 5 seconds | 720p | $0.500 |
| 5 seconds | 1080p | $0.750 |
| 10 seconds | 720p | $1.000 |
| 10 seconds | 1080p | $1.500 |
When to Use
| ✅ Good fit | ❌ Consider alternatives |
|---|---|
| The project needs this exact reference-to-video workflow | The intended task belongs to a different media route |
| Available source media matches every required field | Required assets or usage rights are unavailable |
| The brief can define subject, action, camera, and style | Output must be deterministic at frame or pixel level |
| Supported duration, resolution, and framing fit delivery | Final placement requires unsupported specifications |
| An asynchronous generation job fits production | A live or frame-synchronous response is mandatory |
Prompt Guide
Describe the result as a shot or design brief: identify subjects and references, state the action or transformation, specify environment and composition, then add camera behavior, lighting, pacing, style, sound, and preservation constraints where relevant. Use exact reference identifiers exposed by the local schema.
{
"duration": 5,
"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?'",
"resolution": "720p",
"videos": [
"https://example.com/reference.mp4"
]
}
Technical Specs
| Spec | Value |
|---|---|
| Model ID | alibaba/wan/2.6/reference-to-video |
| Input fields | prompt (string)<br>videos (array)<br>duration (integer; 5, 10)<br>resolution (string; 720p, 1080p)<br>aspect_ratio (string; 1:1, 4:3, 3:4, 16:9, 9:16) |
| Required input | prompt |
| Output fields | url, content_type |
| Execution | Asynchronous job |
Related Models
alibaba/wan/2.6/reference-to-video/flash— Compare this concrete local family route.alibaba/wan/2.6— Compare this concrete local family route.alibaba/wan/2.6/edit— Compare this concrete local family route.

