HappyHorse 视频生成工具，基于阿里云百炼平台 happyhorse-1.0 系列模型，支持图生视频(i2v)、文生视频(t2v)、参考生视频(r2v)、视频编辑(video-edit) 四种模式。自动处理本地媒体文件上传（通过 ossutil 上传到 OSS）、异步任务轮询和视频下载。配置一次，永久使用（API Key 和 OSS 信息保存到 ~/.happy-horse.env）。Use when user asks to generate video with HappyHorse, create image-to-video, text-to-video, reference-to-video, or edit videos using 百炼 platform.

HappyHorse 视频生成

基于百炼平台 happyhorse-1.0 系列模型，一键生成 AI 视频。

脚本位置

• 主脚本：.qoder/skills/happy-horse/scripts/happyhorse.sh
• 环境检查：.qoder/skills/happy-horse/scripts/check-setup.sh
• 保存配置：.qoder/skills/happy-horse/scripts/save-env.sh
• OSS 安装参考：.qoder/skills/happy-horse/reference/ossutils-quick.md

首次使用流程

Step 1：检查环境

bash .qoder/skills/happy-horse/scripts/check-setup.sh

查看输出，确认：

• ossutil：是否已安装（用于上传本地文件）
• DASHSCOPE_API_KEY：百炼 API Key
• OSS 配置：上传本地文件时需要

Step 2：安装 ossutil（如未安装）

按 check-setup.sh 输出的安装命令执行，或参考 reference/ossutils-quick.md。

Step 3：保存缺失配置

向用户询问缺失的配置项，然后保存：

# 保存 API Key（必填）
bash .qoder/skills/happy-horse/scripts/save-env.sh 
  DASHSCOPE_API_KEY=sk-xxxxxxxx

# 保存 OSS 配置（上传本地文件时必填）
bash .qoder/skills/happy-horse/scripts/save-env.sh 
  OSS_ACCESS_KEY_ID=LTAI5t... 
  OSS_ACCESS_KEY_SECRET=xxxxx 
  OSS_BUCKET=my-bucket 
  OSS_REGION=cn-hangzhou

配置保存在 ~/.happy-horse.env，chmod 600 保护，之后每次调用自动加载，无需重复提供。

四种视频模式

i2v：图生视频

以图片首帧生成视频。支持 URL 或本地图片（本地自动上传 OSS）。

# URL 图片
bash .qoder/skills/happy-horse/scripts/happyhorse.sh i2v 
  -i "https://example.com/image.png" 
  -p "让画面缓缓流动，烟雾弥漫" 
  -r 720P -d 5

# 本地图片（自动上传 OSS，获得预签名 URL 后调用 API）
bash .qoder/skills/happy-horse/scripts/happyhorse.sh i2v 
  -i ./happy_horse/images/xiaohongshu/image01.png 
  -p "让马在草原上驰骋" 
  -d 10 --output-dir ./outputs_i2v

参数：

• -i 图片 URL 或本地路径（必填）
• -p prompt 文本或 .txt/.md 文件路径
• -r 分辨率：720P（默认）/ 1080P
• -d 时长：5（默认）/ 10

t2v：文生视频

纯文字生成视频，无需图片。

bash .qoder/skills/happy-horse/scripts/happyhorse.sh t2v 
  -p "一只骏马在秋日草原上奔跑，镜头从侧面跟随，金色光线" 
  -r 1080P -d 5 --ratio 16:9

参数：

• -p prompt 文本或文件路径（必填）
• --ratio 比例：16:9（默认）/ 9:16 / 1:1

r2v：参考生视频

用多张参考图生成视频，适合角色/物品一致性场景。支持最多 3 张参考图。

bash .qoder/skills/happy-horse/scripts/happyhorse.sh r2v 
  -p "身着红色旗袍的女性 图1，镜头侧面中景展现旗袍... 图2 时流苏耳坠摆动..." 
  --ref ./ref-girl.jpg 
  --ref https://example.com/fan.jpg 
  --ref ./ref-earrings.jpg 
  -d 5

参数：

• -p 含 图1 图2 标记的 prompt（必填）
• --ref 参考图 URL 或本地路径，可多次指定（1-3 张，必填）

video-edit：视频编辑

对已有视频按指令修改，可附加参考图。

bash .qoder/skills/happy-horse/scripts/happyhorse.sh video-edit 
  -v "https://example.com/input.mp4" 
  -p "让视频中的角色穿上条纹毛衣" 
  --ref ./sweater.png 
  -r 720P

参数：

• -v 视频 URL 或本地路径（必填）
• -p 编辑指令（必填）
• --ref 参考图（可选）

通用参数

本地文件上传流程

当 -i、-v、--ref 传入本地文件路径时，自动执行：

1. ossutil cp <local_file> oss://<OSS_BUCKET>/happyhorse/<filename>-<timestamp>.<ext>
2. ossutil presign oss://... --timeout 86400 生成 24h 有效预签名 URL
3. 用预签名 URL 调用百炼 API

前提： OSS 配置已保存到 ~/.happy-horse.env

Agent 工作流程

1. 用户提出视频生成需求（描述内容、提供图片/视频）
2. 运行 check-setup.sh 检查环境
3. 如有缺失配置 → 询问用户 → save-env.sh 保存
4. 如 ossutil 未安装 → 执行安装命令（需用户确认 sudo）
5. 根据需求选择模式，运行 happyhorse.sh
6. 等待轮询完成，输出视频保存路径

参考

• OSS 完整文档：happy_horse/reference/ossutils2.0.md
• OSS 安装速查：reference/ossutils-quick.md
• 原始 API 示例：happy_horse/scripts/happyhorse-1.0-*.sh