Wan 2.7 — RunComfy专业套件

Wan-AI的Wan 2.7是一款具备多参考条件控制和音频驱动唇形同步功能的旗舰视频模型，托管在RunComfy Model API上。

bash

npx skills add agentspace-so/runcomfy-skills --skill wan-2-7 -g

何时选择该模型（对比其他同系列模型）

你的需求	使用模型
将视频与你提供的音轨进行唇形同步	Wan 2.7（使用 `audio_url` ）
多参考精细运动控制	Wan 2.7
流畅转场、精准运动物理效果	Wan 2.7
当前盲投排名第一的视频模型	HappyHorse 1.0
支持图像+视频+音频参考的多模态电影级效果，且可生成旁白	Seedance 2.0 Pro
对现有素材进行电影级运动编辑	Kling Video O1
超快速迭代	LTX 2

如果用户明确提到"Wan" / "Wan 2.7" / "wan-ai" / "alibaba video"，无论需求如何都路由到该模型。

前置条件

RunComfy CLI — 执行
```
npm i -g @runcomfy/cli
```
安装
RunComfy账户 — 执行
```
runcomfy login
```
会打开浏览器设备码登录流程
CI/容器环境 — 设置环境变量
```
RUNCOMFY_TOKEN=<token>
```
替代
```
runcomfy login
```

端点与输入规范

wan-ai/wan-2-7/text-to-video

字段	类型	必填	默认值	说明
`prompt`	字符串	是	—	最多约5000字符 / 1500 tokens
`audio_url`	字符串	否	—	WAV/MP3格式，时长3–30秒，文件≤15MB。用于驱动唇形同步。若省略则自动生成背景音乐
`aspect_ratio`	枚举值	否	`16:9`	可选值： `16:9` , `9:16` , `1:1` , `4:3` , `3:4`
`resolution`	枚举值	否	`1080p`	可选值： `720p` 或 `1080p`
`duration`	枚举值	否	`5`	取值范围2–15（整数秒）
`negative_prompt`	字符串	否	—	最多500字符，用于指定需要避免的具体问题
`enable_prompt_expansion`	布尔值	否	true	自动改写简短提示词。若需精准控制可关闭该选项
`seed`	整数	否	—	取值范围0..2^31-1。重复使用可生成同主题变体

调用方式

默认配置（5秒1080p 16:9，启用提示词扩展）：

bash

runcomfy run wan-ai/wan-2-7/text-to-video \
  --input '{"prompt": "<用户提示词>"}' \
  --output-dir <绝对路径>

音频驱动唇形同步（使用自定义音轨）：

bash

runcomfy run wan-ai/wan-2-7/text-to-video \
  --input '{
    "prompt": "发言人的中近景镜头，暖色调主光源，固定三脚架，轻微呼吸动作。",
    "audio_url": "https://.../voiceover.mp3",
    "duration": 12,
    "aspect_ratio": "9:16"
  }' \
  --output-dir <绝对路径>

精准控制（关闭自动扩展）：

bash

runcomfy run wan-ai/wan-2-7/text-to-video \
  --input '{
    "prompt": "<你想要的精准内容，一字不差>",
    "enable_prompt_expansion": false,
    "negative_prompt": "无字幕，无闪烁，无手部变形"
  }' \
  --output-dir <绝对路径>

提示词技巧 — 有效方法

用直白英语描述镜头与运动。比如"缓慢推镜"、"固定三脚架，低角度"、"手持跟拍"、"从上方摇镜头"。将镜头描述放在提示词开头。

每个片段一个核心动作。不要堆叠多个冲突动作。选择重点：比如"她转身，然后微笑"而非"她转身并且微笑还有公交车经过并且..."。

用
negative_prompt
指定具体问题。正确示例："无字幕，无水印，无闪烁"。错误示例（模糊）："无糟糕灯光"。

默认启用提示词扩展。简短提示词会被模型自动改写。若需简洁/精准的提示词（如品牌严格的广告文案），可设置

enable_prompt_expansion: false

关闭。

音频规格很重要。

audio_url

必须是3–30秒、≤15MB的WAV/MP3文件。超出范围的文件会被拒绝。音频时长需与片段时长匹配。

迭代seed值。当你希望同一提示词的变体输出保持一致时，重复使用相同的seed值。更换seed值可获得完全不同的输出。

反模式：

静态画面描述 → 运动效果会模糊不清
模糊的负面提示词（"无糟糕色彩"）→ 会被忽略
超出3–30秒/15MB/WAV-MP3规格的音频 → 会被拒绝
超过5000字符/1500 tokens的提示词 → 输出质量下降

优势场景

使用场景	Wan 2.7的优势
带自定义旁白的唇形同步广告	`audio_url` 支持导入自定义音轨
多语言配音变体	同一提示词，为不同语言使用不同 `audio_url`
多参考运动控制	最多支持5种参考媒体（图像/视频/音频）
流畅转场+运动物理效果	具备强大的物理感知运动先验模型
通过负面提示词获得干净输出	可针对性排除问题

经过验证的优秀提示词示例

产品展示示例：

大理石台面上产品的电影级中景镜头，柔和的工作室灯光，缓慢细微的推镜，浅景深，高端商业风格，清晰1080p细节

唇形同步发言人（搭配
audio_url
）：

光线柔和的录音棚中自信发言人的中近景镜头，微微倾向镜头，固定三脚架，浅景深，镜头左侧的暖色调主光源

垂直平台原生内容：

9:16竖版短视频。咖啡师萃取一份浓缩咖啡，蒸汽融入晨光，浓郁的油脂缓慢形成。手持近景，浅景深，温馨咖啡馆氛围

局限性

时长上限15秒。如需更长叙事，需拼接多次调用结果
不原生支持4K — 最高分辨率为1080p
宽高比限制 — 仅支持文档中列出的5种取值
音频规格限制 — 仅支持3–30秒、≤15MB的WAV/MP3格式
参考媒体上限5个（图像+视频+音频总和）
如需在生成过程中直接生成旁白（无需单独音轨），请使用Seedance 2.0 Pro — Wan仅支持导入音频，不支持生成音频

退出码

代码	含义
0	成功
64	CLI参数错误
65	输入JSON错误/规格不匹配
69	上游服务5xx错误
75	可重试：超时/429请求过多
77	未登录或令牌被拒绝

完整参考：docs.runcomfy.com/cli/troubleshooting

工作原理

该技能调用

runcomfy run wan-ai/wan-2-7/text-to-video

并传入符合规格的JSON参数。CLI会向

https://model-api.runcomfy.net/v1/models/wan-ai/wan-2-7/text-to-video

发送POST请求，轮询请求状态，获取结果，并将所有

.runcomfy.net

.runcomfy.com

链接的内容下载到

--output-dir

指定的目录。按

Ctrl-C

会在退出前取消远程请求。

安全与隐私

令牌存储：
```
runcomfy login
```
会将API令牌写入
```
~/.config/runcomfy/token.json
```
，权限设置为0600（仅所有者可读写）。在CI/容器环境中，可设置
```
RUNCOMFY_TOKEN
```
环境变量来避免使用该文件。
输入边界：用户提示词通过
```
--input
```
以JSON字符串形式传递给CLI。CLI不会对提示词进行shell扩展，而是直接通过HTTPS将JSON主体传输给Model API。提示词内容不会造成shell注入风险。
第三方内容：你传入的图像/蒙版/视频链接由RunComfy模型服务器获取，而非本地CLI。请将外部链接视为不可信；基于图像的提示词注入是所有图像编辑/视频编辑模型的已知风险。
出站端点：仅允许访问
```
model-api.runcomfy.net
```
（提交请求）和
```
*.runcomfy.net
```
/
```
*.runcomfy.com
```
（下载生成结果的白名单）。无遥测，无回调。
生成文件大小限制：CLI会中止任何超过2 GiB的单个下载，以防止恶意或异常模型输出占满磁盘空间。

wan-2-7

NPX安装

标签

SKILL.md 内容（中文）

Wan 2.7 — RunComfy专业套件

何时选择该模型（对比其他同系列模型）

前置条件

端点与输入规范

`wan-ai/wan-2-7/text-to-video`

调用方式

提示词技巧 — 有效方法

优势场景

经过验证的优秀提示词示例

局限性

退出码

工作原理

安全与隐私