HappyHorse 视频生成与编辑模型

HappyHorse 视频生成与编辑模型由阿里巴巴集团开发，本技能集成于 ModelStudio（阿里云模型服务平台）的 HappyHorse 模型 API。

模型概览

文本生成视频（happyhorse-1.0-t2v）

根据文本提示生成视频。

text2video task-submit

python3 {baseDir}/scripts/happyhorse-magic.py text2video-gen --prompt "一座由硬纸板和瓶盖搭建的微型城市，在夜晚焕发出生机" --resolution "720P" --ratio "16:9" --duration 5
python3 {baseDir}/scripts/happyhorse-magic.py text2video-gen --prompt "一只可爱的小猫将军站在悬崖上，远处是壮丽的雪山" --resolution "1080P" --ratio "16:9" --duration 10
python3 {baseDir}/scripts/happyhorse-magic.py text2video-gen --prompt "海浪拍打岩石的慢镜头" --resolution "720P" --ratio "9:16" --duration 8 --no-watermark

参数说明

• --prompt：视频生成的文本提示（必填），最多支持 5000 个非中文字符或 2500 个中文字符
• --resolution：视频分辨率，可选 720P 或 1080P（默认：1080P）
• --ratio：画面比例，可选 16:9、9:16、1:1、4:3、3:4（默认：16:9）
• --duration：视频时长（单位：秒），范围为 3-15 秒（默认：5）
• --no-watermark：关闭“Happy Horse”水印（默认：开启）
• --seed：随机种子，用于结果复现，取值范围 [0, 2147483647]

text2video tasks-get（轮询获取任务状态）

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

图像生成视频（happyhorse-1.0-i2v）

根据首帧图像生成视频。输出画面比例将自动匹配输入图像的宽高比。

首帧图像生成视频

python3 {baseDir}/scripts/happyhorse-magic.py image2video-gen --prompt "一只猫在草地上奔跑" --first-frame "https://example.com/cat.png" --resolution "720P" --duration 5
python3 {baseDir}/scripts/happyhorse-magic.py image2video-gen --first-frame "https://example.com/landscape.jpg" --resolution "1080P" --duration 10
python3 {baseDir}/scripts/happyhorse-magic.py image2video-gen --prompt "花朵缓缓绽放" --first-frame "https://example.com/flower.png" --duration 8 --no-watermark

参数说明

• --prompt：视频生成的文本提示（可选但建议填写）
• --first-frame：首帧图像的 URL（必填）。支持格式：JPEG/JPG/PNG/WEBP，最小边不低于 300px，文件大小不超过 10MB
• --resolution：视频分辨率，可选 720P 或 1080P（默认：1080P）。输出比例将自动匹配输入图像
• --duration：视频时长（单位：秒），范围为 3-15 秒（默认：5）
• --no-watermark：关闭“Happy Horse”水印（默认：开启）
• --seed：随机种子，用于结果复现，取值范围 [0, 2147483647]

注意：不提供 --ratio 参数，输出视频的宽高比将自动匹配输入图像。

image2video tasks-get（轮询获取任务状态）

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

参考图像生成视频（happyhorse-1.0-r2v）

根据参考图像生成视频，可将图像作为角色或物体来源。在提示中使用 character1、character2 等标识符，按数组顺序引用图像。

多角色参考生成

python3 {baseDir}/scripts/happyhorse-magic.py reference2video-gen --prompt "身着红色旗袍的女性character1，镜头以侧面中景勾勒旗袍修身剪裁" --reference-images "https://example.com/girl.jpg" --resolution "720P" --ratio "16:9" --duration 5
python3 {baseDir}/scripts/happyhorse-magic.py reference2video-gen --prompt "身着红色旗袍的女性character1，轻抬玉手展开折扇character2时流苏耳坠character3随头部转动轻盈摆动" --reference-images "https://example.com/girl.jpg" "https://example.com/fan.jpg" "https://example.com/earrings.jpg" --resolution "720P" --ratio "16:9" --duration 5
python3 {baseDir}/scripts/happyhorse-magic.py reference2video-gen --prompt "character1在海边散步，阳光洒在沙滩上" --reference-images "https://example.com/person.png" --resolution "1080P" --ratio "16:9" --duration 10

参数说明

• --prompt：包含角色引用的文本提示（必填），最多支持 5000 个非中文字符。使用 character1/character2/... 按数组顺序引用图像
• --reference-images：参考图像的 URL 列表（必填），数量为 1-9 张。第 1 张对应 character1，第 2 张对应 character2，依此类推
• --resolution：视频分辨率，可选 720P 或 1080P（默认：1080P）
• --ratio：画面比例，可选 16:9、9:16、1:1、4:3、3:4（默认：16:9）
• --duration：视频时长（单位：秒），范围为 3-15 秒（默认：5）
• --no-watermark：关闭“Happy Horse”水印（默认：开启）
• --seed：随机种子，用于结果复现，取值范围 [0, 2147483647]

注意：参考图像的短边应不小于 400px。避免使用低分辨率、模糊或严重压缩的图像。

reference2video tasks-get（轮询获取任务状态）

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

视频编辑（happyhorse-1.0-video-edit）

通过文本指令和可选参考图像对已有视频进行编辑。支持风格迁移、局部替换等操作。

基于指令的编辑

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

基于参考图像的编辑

python3 {baseDir}/scripts/happyhorse-magic.py video-edit --prompt "让视频中的角色穿上图片中的条纹毛衣" --video "https://example.com/video.mp4" --reference-images "https://example.com/clothes.webp"
python3 {baseDir}/scripts/happyhorse-magic.py video-edit --prompt "将背景替换为参考图中的场景" --video "https://example.com/video.mp4" --reference-images "https://example.com/bg.jpg" --resolution "720P"

参数说明

• --prompt: 编辑指令（必填，最多 5000 个非中文字符）
• --video: 待编辑的视频 URL（必填，支持 mp4/mov 格式，输入时长 3-60 秒，输出最大 15 秒）
• --reference-images: 用于编辑的参考图像 URL（可选，最多 5 张）
• --resolution: 输出分辨率 - 720P 或 1080P（默认：1080P）
• --audio-setting: 音频处理方式 - auto（默认）或 origin（保留原始音频）
• --no-watermark: 禁用“Happy Horse”水印（默认：启用）
• --seed: 随机种子，用于结果复现 [0, 2147483647]

注意：输出画面比例和时长与输入视频保持一致。不支持 --ratio 或 --duration 参数。若输入视频超过 15 秒，系统将自动截取前 15 秒。

获取任务状态（轮询模式）

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

与 Wan 2.7 的主要差异

重要注意事项

• 任务 ID 有效期：任务 ID 有效时间为 24 小时
• 视频链接有效期：生成的视频下载链接有效时间为 24 小时，请及时下载
• 内容审核：输入和输出内容均需经过内容安全审查
• 计费规则：按分辨率（1080P > 720P）× 时长（秒数）计费
• 水印：默认启用“Happy Horse”文字水印；如需关闭，请使用 --no-watermark 选项