scenario-wan — Claude Code skill: Wan video generation

---
name: scenario-wan
description: "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."
license: MIT
---

# 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, ask the
user to install it (`npx skills add scenario-labs/skills --skill <name>`); 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

1. `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).
2. `model_schema_get` with that id: exclusivity notes, caps, defaults.
3. `upload_asset` the opening and closing stills (see the `scenario` skill) for asset ids.
4. `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.
5. 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`.
6. `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.