Wan 2.7 视频模型

Wan 2.7 视频模型由阿里巴巴集团研发，是最新一代的视频生成与编辑模型。本技能集成于 ModelStudio（阿里云模型服务平台）上的 Wan 2.7 模型 API。

模型概览

文本生成视频（wan2.7-t2v）

通过文本提示生成视频，支持可选音频。

text2video task-submit

python3 {baseDir}/scripts/wan27-magic.py text2video-gen --prompt "一只小猫在月光下奔跑" --resolution "1080P" --ratio "16:9" --duration 5
python3 {baseDir}/scripts/wan27-magic.py text2video-gen --prompt "一段紧张刺激的侦探追查故事，展现电影级叙事能力。第1个镜头[0-3秒] 全景:雨夜的纽约街头，霓虹灯闪烁，一位身穿黑色风衣的侦探快步行走。 第2个镜头[3-6秒] 中景:侦探进入一栋老旧建筑，雨水打湿了他的外套，门在他身后缓缓关闭。 第3个镜头[6-9秒] 特写:侦探的眼神坚毅专注，远处传来警笛声，他微微皱眉思考。 第4个镜头[9-12秒] 中景:侦探在昏暗走廊中小心前行，手电筒照亮前方。 第5个镜头[12-15秒] 特写:侦探发现关键线索，脸上露出恍然大悟的表情。" --resolution "720P" --ratio "16:9" --duration 15
python3 {baseDir}/scripts/wan27-magic.py text2video-gen --prompt "一幅史诗级可爱的场景，一只小猫将军站在悬崖上" --audio-url "https://example.com/audio.mp3" --duration 10

参数说明

• --prompt: 视频生成的文本提示（必填，最大 5000 字符）
• --negative-prompt: 视频中应避免的内容（可选，最大 500 字符）
• --resolution: 视频分辨率 - 720P 或 1080P（默认：1080P）
• --ratio: 画面比例 - 16:9、9:16、1:1、4:3、3:4（默认：16:9）
• --duration: 视频时长（单位：秒），范围 2-15（默认：5）
• --audio-url: 自定义音频 URL（可选，支持 wav/mp3 格式，时长 2-30 秒）
• --prompt-extend: 启用智能提示重写功能（默认启用）
• --no-prompt-extend: 禁用智能提示重写功能
• --watermark: 添加“AI Generated”水印（默认关闭）

text2video tasks-get（轮询获取任务结果）

python3 {baseDir}/scripts/wan27-magic.py text2video-get --task-id "<TASK_ID_FROM_VIDEO_GEN>"

图像生成视频（wan2.7-i2v）

根据图像生成视频，支持首帧、首尾帧及视频续写。

首帧生成视频

python3 {baseDir}/scripts/wan27-magic.py image2video-gen --prompt "一幅都市奇幻艺术的场景" --first-frame "https://example.com/first.png" --resolution "720P" --duration 10
python3 {baseDir}/scripts/wan27-magic.py image2video-gen --prompt "一幅都市奇幻艺术的场景。一个充满动感的涂鸦艺术角色。一个由喷漆所画成的少年，正从一面混凝土墙上活过来。他一边用极快的语速演唱一首英文rap，一边摆着一个经典的、充满活力的说唱歌手姿势。场景设定在夜晚一个充满都市感的铁路桥下。灯光来自一盏孤零零的街灯，营造出电影般的氛围，充满高能量和惊人的细节。视频的音频部分完全由他的rap构成，没有其他对话或杂音。" --first-frame "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png" --driving-audio "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/ozwpvi/rap.mp3" --duration 10

首尾帧生成视频

python3 {baseDir}/scripts/wan27-magic.py image2video-gen --prompt "写实风格，一只小黑猫好奇地仰望天空，镜头从平视角度逐渐升高，最后以俯视角度捕捉到它好奇的眼神。" --first-frame "https://wanx.alicdn.com/material/20250318/first_frame.png" --last-frame "https://wanx.alicdn.com/material/20250318/last_frame.png" --no-prompt-extend --resolution "720P" --duration 10

视频续写（首段视频 + 提示 或 首段视频 + 尾帧）

python3 {baseDir}/scripts/wan27-magic.py image2video-gen --prompt "一只戴着墨镜的狗在街道上滑滑板" --first-clip "http://wanx.alicdn.com/material/20250318/video_extension_1.mp4" --no-prompt-extend --resolution "720P" --duration 15
python3 {baseDir}/scripts/wan27-magic.py image2video-gen --prompt "继续之前的场景" --first-clip "https://example.com/video.mp4" --last-frame "https://example.com/end.png" --duration 10

参数说明

• --prompt: 文本提示（可选但建议填写，最大 5000 字符）
• --negative-prompt: 应避免的内容（可选，最大 500 字符）
• --first-frame: 首帧图像 URL（首帧模式必需）
• --last-frame: 末帧图像 URL（可选，用于首尾帧模式）
• --first-clip: 首段视频片段 URL（视频续写模式必需，时长 2-10 秒）
• --driving-audio: 驱动视频的音频 URL（可选，支持 wav/mp3 格式，时长 2-30 秒）
• --resolution: 视频分辨率 - 720P 或 1080P（默认：1080P）
• --duration: 视频时长（单位：秒），范围 2-15（默认：5）
• --prompt-extend: 启用智能提示重写功能（默认启用）
• --no-prompt-extend: 禁用智能提示重写功能
• --watermark: 添加水印（默认关闭）

image2video tasks-get（轮询获取任务结果）

python3 {baseDir}/scripts/wan27-magic.py image2video-get --task-id "<TASK_ID_FROM_VIDEO_GEN>"

参考生成视频（wan2.7-r2v）

使用参考图像或视频作为角色/场景来源生成视频。

多角色参考

python3 {baseDir}/scripts/wan27-magic.py reference2video-gen --prompt "视频1在沙发上看电影，图片1在旁边唱歌" --reference-videos "https://example.com/person.mp4" --reference-images "https://example.com/singer.png" --resolution "720P" --duration 10
python3 {baseDir}/scripts/wan27-magic.py reference2video-gen --prompt "视频1对视频2说：听起来不错" --reference-videos "https://example.com/role1.mp4" "https://example.com/role2.mp4" --resolution "1080P" --ratio "16:9" --duration 10
python3 {baseDir}/scripts/wan27-magic.py reference2video-gen --prompt "视频1一边喝奶茶，一边随着音乐即兴跳舞" --reference-videos "https://cdn.wanx.aliyuncs.com/static/demo-wan26/vace.mp4" --resolution "720P" --duration 10
python3 {baseDir}/scripts/wan27-magic.py reference2video-gen --prompt "视频2中的角色坐在靠窗的椅子上，手持图片1，在图片2旁演奏一首舒缓的美国乡村民谣。视频1的角色对视频2角色开口说道：“听起来不错”" --reference-videos "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/hfugmr/wan-r2v-role1.mp4" "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qigswt/wan-r2v-role2.mp4" --reference-images "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qpzxps/wan-r2v-object4.png" "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/wfjikw/wan-r2v-backgroud5.png" --resolution "1080P" --duration 10
python3 {baseDir}/scripts/wan27-magic.py reference2video-gen --prompt "视频1对接镜头唱起了rap嘻哈音乐" --reference-videos "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/hfugmr/wan-r2v-role1.mp4" --reference-voice "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/ozwpvi/rap.mp3" --resolution "720P" --duration 10

基于首帧控制

python3 {baseDir}/scripts/wan27-magic.py reference2video-gen --prompt "图片1在海边散步" --reference-images "https://example.com/person.png" --first-frame "https://example.com/beach.png" --resolution "720P" --duration 5
python3 {baseDir}/scripts/wan27-magic.py reference2video-gen --prompt "视频1戴着一副头戴式耳机，似乎在听着非常有节奏的音乐，非常快乐，走进这家咖啡厅，拿起桌上的报纸看起来" --reference-videos "https://cdn.wanx.aliyuncs.com/static/demo-wan26/vace.mp4" --first-frame "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/wfjikw/wan-r2v-backgroud5.png" --resolution "720P" --duration 10

参数说明

• --prompt: 文本提示，包含角色引用（必填，最大 5000 字符）。使用“视频1/视频2”引用视频，“图片1/图片2”引用图片。
• --negative-prompt: 需避免的内容（可选，最大 500 字符）
• --reference-videos: 参考视频 URL（最多 3 个）。在提示中以“视频1”、“视频2”等表示。
• --reference-images: 参考图片 URL（最多 5 张）。在提示中以“图片1”、“图片2”等表示。
• --first-frame: 首帧图像 URL（可选）
• --reference-voice: 特定角色的语音音频 URL（可选，支持 wav/mp3 格式，时长 1-10 秒）
• --resolution: 视频分辨率 - 720P 或 1080P（默认：1080P）
• --ratio: 宽高比 - 16:9、9:16、1:1、4:3、3:4（默认：16:9）。若提供首帧则忽略此参数。
• --duration: 视频时长 2-10 秒（默认：5）
• --watermark: 添加水印（默认关闭）

注意：--reference-videos 和 --reference-images 至少需提供其一。

reference2video 任务查询（轮询模式）

python3 {baseDir}/scripts/wan27-magic.py reference2video-get --task-id "<TASK_ID_FROM_VIDEO_GEN>"

视频编辑功能（wan2.7-videoedit）

通过文本指令和可选参考图对已有视频进行编辑。

基于指令的编辑

python3 {baseDir}/scripts/wan27-magic.py video-edit --prompt "为人物换上酷闪的衣服" --video "https://example.com/original.mp4" --resolution "720P"
python3 {baseDir}/scripts/wan27-magic.py video-edit --prompt "将场景变成夜晚，添加霓虹灯效果" --video "https://example.com/video.mp4"

基于参考图的编辑

python3 {baseDir}/scripts/wan27-magic.py video-edit --prompt "为人物换上参考图里的帽子" --video "https://example.com/video.mp4" --reference-images "https://example.com/hat.png"
python3 {baseDir}/scripts/wan27-magic.py video-edit --prompt "参考视频运镜和动作，用一个卡通小狗形象实现类似效果" --video "https://example.com/video.mp4" --reference-images "https://example.com/dog.png"

参数说明

• --prompt: 编辑指令（建议填写，最大 5000 字符）
• --negative-prompt: 需避免的内容（可选，最大 500 字符）
• --video: 待编辑的输入视频 URL（必填，支持 mp4/mov 格式，时长 2-10 秒）
• --reference-images: 用于编辑的参考图片 URL（可选，最多 3 张）
• --resolution: 输出分辨率 - 720P 或 1080P（默认：1080P）
• --ratio: 输出宽高比（可选）。未设置时使用输入视频的原始比例。
• --duration: 输出时长（可选，0 表示与原视频相同，范围 2-10 秒）
• --audio-setting: 音频处理方式 - auto（默认）或 origin（保留原始音频）
• --watermark: 添加水印（默认关闭）

注意：--prompt-extend 不支持用于 wan2.7-videoedit。

video-edit 任务查询（轮询模式）

python3 {baseDir}/scripts/wan27-magic.py video-edit-get --task-id "<TASK_ID_FROM_VIDEO_EDIT>"

分辨率与宽高比对照表

重要提示

• 任务ID有效期：任务ID在24小时内有效
• 视频链接有效期：生成的视频链接在24小时内有效，请及时下载
• 内容审核：输入和输出内容均需通过内容安全审查
• 计费规则：按分辨率（1080P > 720P）× 持续时间（秒数）计费
• 多镜头叙事：在提示词中使用自然语言描述镜头（例如：“第1个镜头[0-3秒]...”）
• 从 wan2.6 迁移说明：wan2.7 使用 resolution + ratio 替代 size，shot_type 参数已弃用（请改用提示词描述）