Scenario Wan Video
Overview
Wan, Alibaba's video family on Scenario, ships each job as its own member, and members a generation
apart disagree on parameter names, not just numbers: pick the member with search, then treat
model_schema_get as the contract before every run. Wan 2.7 Image is an image model, covered by the
scenario-image skill.
Connection and the core loop: see the scenario skill in this repo; model-agnostic video work: the
scenario-video skill. If a sibling skill named here is missing from your available skills, load it
with skill_get (Scenario MCP) or ask the user to install it
(https://github.com/scenario-labs/skills#install); unattended, proceed from tool schemas and flag
the gap.
Quick reference
Members by job (at authoring time):
| Job |
Member |
Required inputs |
| Text to video |
2.7, 2.6, 2.5 T2V |
prompt |
| Animate a still |
2.7, 2.6, 2.5 I2V |
image + motion prompt |
| Extend a clip |
2.7 I2V |
video + prompt (excludes image) |
| Restyle footage |
2.7 Video Edit |
video + edit prompt |
| Character performs a video's motion |
2.2 Animate (Move) |
imageUrl + videoUrl |
| Swap the person in footage |
2.2 Animate (Replace) |
videoUrl + imageUrl |
| Change aspect ratio |
2.2 Reframe |
videoUrl |
| Expand the canvas |
2.2 Outpainting |
videoUrl + prompt |
Parameters do not port across generations. At authoring time: the 2.7 generators take resolution
(720p or 1080p) and whole-second duration from 2 to 15, with aspectRatio (16:9 through 3:4) on
T2V only. 2.6 and 2.5 T2V instead take one size string such as "1920*1080", with duration from
a fixed grid (5, 10, or 15 on 2.6; 5 or 10 on 2.5), while their I2V members take resolution. Video
Edit takes a 2 to 10 second source; its duration is optional and truncates. Reframe and
Outpainting have no duration: length is numFrames (81 to 241) at framesPerSecond (5 to 30),
and output matches the source only when matchInputNumFrames and matchInputFramesPerSecond are
true (both default false). Outpainting guides new content with up to 10 refImageUrls.
On 2.7 I2V, image and video are mutually exclusive, and endImage (last frame) is only valid
alongside image. Resolution and duration carry cost (1080p ran about triple 720p on 2.7 T2V at
authoring time), so dry_run before batches.
Prompt the member's job
T2V wants a full scene in natural language: subject action, one camera move, lighting, style tags.
I2V wants motion only: the still already fixes look and composition, so re-describing it wastes the
prompt. Video Edit wants instructions, one clear change per sentence with a precise target, plus
preservation language ("keep subject identity and camera path"); referenceImage carries a target
look. In-frame readable text is unreliable on every member; push artifacts into negativePrompt
(Video Edit and Animate lack it).
2.6 alone does multi-shot: with multiShots true (the default, but active only while
enablePromptExpansion is true), open with a global style line, then Shot 1 [0-3s] ...,
Shot 2 [3-7s] ..., keeping characters and location continuous. enablePromptExpansion defaults
true on the generators (helps thin prompts, adds latency) and false on Reframe and Outpainting.
Where the audio comes from
The 2.7 generators always deliver audio: upload an audio file to drive it, or omit it and a synced
track is generated from whatever sound the prompt describes, so prompt the ambience you want. On 2.6
and 2.5, audio comes only from an uploaded file (3 to 30 seconds, 15 MB or less at authoring time),
which 2.6 lip-syncs. Video Edit's audioSetting decides the track: origin keeps the source audio,
auto lets the model regenerate it. Animate carries the source track while mergeAudio stays true
(the default).
Worked example: bracket a shot between two stills
search with target="models", query="wan image to video", public=true. Prefer the newest
non-deprecated hit, e.g. model_wan-2-7-i2v (a live hit at authoring time: re-discover each
session).
model_schema_get with that id: exclusivity notes, caps, defaults.
upload_asset the opening and closing stills (see the scenario skill) for asset ids.
model_run with that model_id, dry_run=true, and
parameters={"prompt": "She turns from the window and walks toward the door, coat swaying; slow push-in. Room tone and distant traffic.", "image": "asset_open", "endImage": "asset_close", "duration": 5, "resolution": "1080p"}
for the cost estimate; re-estimate after changing duration or resolution.
- Re-run with
wait=false, then jobs_wait with the returned job id, re-called with
pending_job_ids on timeout, never a second model_run.
asset_display the output and review motion and audio together.
Common mistakes
- Combining
image with video on 2.7 I2V, or passing endImage without image: the schema
forbids both.
- Porting a 2.7 payload to 2.6 or 2.5 T2V: they take
size ("1280*720" style), not resolution
plus aspectRatio, and off-grid durations fail.
- Expecting Reframe or Outpainting to preserve length: defaults render 81 frames at 16 fps; set the
two match flags.
- Outpainting's expand flags default to all four sides: set the unwanted directions (
expandTop,
expandBottom, expandLeft, expandRight) to false.
- Writing shot brackets with
enablePromptExpansion false: multiShots is inert without it; no
other member reads brackets.
- Re-describing the still or requesting content changes in an I2V prompt: I2V animates; Video Edit
changes content.
1---2name: scenario-wan3description: "Use when generating or editing video with Wan models on Scenario via MCP: text-to-video, image-to-video from a still, first and last frame brackets, extending a clip, instruction-based video editing, character motion transfer or person replacement (Animate), aspect ratio reframing, video outpainting, uploaded-audio sync or auto-generated audio, or multi-shot prompts with timing brackets. Keywords: Wan 2.7, 2.6, 2.5, 2.2, Alibaba, VACE, T2V, I2V, V2V, lip-sync, multiShots."4license: MIT5metadata:6 source: https://skillmd.com/skills/scenario-labs/scenario-wan7---89# Scenario Wan Video1011## Overview1213Wan, Alibaba's video family on Scenario, ships each job as its own member, and members a generation14apart disagree on parameter names, not just numbers: pick the member with `search`, then treat15`model_schema_get` as the contract before every run. Wan 2.7 Image is an image model, covered by the16`scenario-image` skill.1718Connection and the core loop: see the `scenario` skill in this repo; model-agnostic video work: the19`scenario-video` skill. If a sibling skill named here is missing from your available skills, load it20with `skill_get` (Scenario MCP) or ask the user to install it21(https://github.com/scenario-labs/skills#install); unattended, proceed from tool schemas and flag22the gap.2324## Quick reference2526Members by job (at authoring time):2728| Job | Member | Required inputs |29| ----------------------------------- | --------------------- | ------------------------------------- |30| Text to video | 2.7, 2.6, 2.5 T2V | `prompt` |31| Animate a still | 2.7, 2.6, 2.5 I2V | `image` + motion `prompt` |32| Extend a clip | 2.7 I2V | `video` + `prompt` (excludes `image`) |33| Restyle footage | 2.7 Video Edit | `video` + edit `prompt` |34| Character performs a video's motion | 2.2 Animate (Move) | `imageUrl` + `videoUrl` |35| Swap the person in footage | 2.2 Animate (Replace) | `videoUrl` + `imageUrl` |36| Change aspect ratio | 2.2 Reframe | `videoUrl` |37| Expand the canvas | 2.2 Outpainting | `videoUrl` + `prompt` |3839Parameters do not port across generations. At authoring time: the 2.7 generators take `resolution`40(720p or 1080p) and whole-second `duration` from 2 to 15, with `aspectRatio` (16:9 through 3:4) on41T2V only. 2.6 and 2.5 T2V instead take one `size` string such as `"1920*1080"`, with `duration` from42a fixed grid (5, 10, or 15 on 2.6; 5 or 10 on 2.5), while their I2V members take `resolution`. Video43Edit takes a 2 to 10 second source; its `duration` is optional and truncates. Reframe and44Outpainting have no `duration`: length is `numFrames` (81 to 241) at `framesPerSecond` (5 to 30),45and output matches the source only when `matchInputNumFrames` and `matchInputFramesPerSecond` are46true (both default false). Outpainting guides new content with up to 10 `refImageUrls`.4748On 2.7 I2V, `image` and `video` are mutually exclusive, and `endImage` (last frame) is only valid49alongside `image`. Resolution and duration carry cost (1080p ran about triple 720p on 2.7 T2V at50authoring time), so `dry_run` before batches.5152## Prompt the member's job5354T2V wants a full scene in natural language: subject action, one camera move, lighting, style tags.55I2V wants motion only: the still already fixes look and composition, so re-describing it wastes the56prompt. Video Edit wants instructions, one clear change per sentence with a precise target, plus57preservation language ("keep subject identity and camera path"); `referenceImage` carries a target58look. In-frame readable text is unreliable on every member; push artifacts into `negativePrompt`59(Video Edit and Animate lack it).60612.6 alone does multi-shot: with `multiShots` true (the default, but active only while62`enablePromptExpansion` is true), open with a global style line, then `Shot 1 [0-3s] ...`,63`Shot 2 [3-7s] ...`, keeping characters and location continuous. `enablePromptExpansion` defaults64true on the generators (helps thin prompts, adds latency) and false on Reframe and Outpainting.6566## Where the audio comes from6768The 2.7 generators always deliver audio: upload an `audio` file to drive it, or omit it and a synced69track is generated from whatever sound the prompt describes, so prompt the ambience you want. On 2.670and 2.5, audio comes only from an uploaded file (3 to 30 seconds, 15 MB or less at authoring time),71which 2.6 lip-syncs. Video Edit's `audioSetting` decides the track: `origin` keeps the source audio,72`auto` lets the model regenerate it. Animate carries the source track while `mergeAudio` stays true73(the default).7475## Worked example: bracket a shot between two stills76771. `search` with `target="models"`, `query="wan image to video"`, `public=true`. Prefer the newest78 non-deprecated hit, e.g. `model_wan-2-7-i2v` (a live hit at authoring time: re-discover each79 session).802. `model_schema_get` with that id: exclusivity notes, caps, defaults.813. `upload_asset` the opening and closing stills (see the `scenario` skill) for asset ids.824. `model_run` with that `model_id`, `dry_run=true`, and83 `parameters={"prompt": "She turns from the window and walks toward the door, coat swaying; slow push-in. Room tone and distant traffic.", "image": "asset_open", "endImage": "asset_close", "duration": 5, "resolution": "1080p"}`84 for the cost estimate; re-estimate after changing duration or resolution.855. Re-run with `wait=false`, then `jobs_wait` with the returned job id, re-called with86 `pending_job_ids` on timeout, never a second `model_run`.876. `asset_display` the output and review motion and audio together.8889## Common mistakes9091- Combining `image` with `video` on 2.7 I2V, or passing `endImage` without `image`: the schema92 forbids both.93- Porting a 2.7 payload to 2.6 or 2.5 T2V: they take `size` (`"1280*720"` style), not `resolution`94 plus `aspectRatio`, and off-grid durations fail.95- Expecting Reframe or Outpainting to preserve length: defaults render 81 frames at 16 fps; set the96 two match flags.97- Outpainting's expand flags default to all four sides: set the unwanted directions (`expandTop`,98 `expandBottom`, `expandLeft`, `expandRight`) to false.99- Writing shot brackets with `enablePromptExpansion` false: `multiShots` is inert without it; no100 other member reads brackets.101- Re-describing the still or requesting content changes in an I2V prompt: I2V animates; Video Edit102 changes content.