可灵 Omni-Video 视频生成与编辑

通过 scripts/generate_video.sh 完成视频全流程（提交任务 → 轮询状态 → 下载文件）。

使用方式

bash <skill-dir>/scripts/generate_video.sh \
  --prompt "视频描述" \
  [--model kling-video-o1] \
  [--output ./output.mp4] \
  [--aspect-ratio 16:9|9:16|1:1] \
  [--duration 5] \
  [--mode pro|std] \
  [--sound on|off] \
  [--image <url-or-base64>] \
  [--image-type first_frame|end_frame] \
  [--image2 <url-or-base64>] \
  [--image2-type first_frame|end_frame] \
  [--video <url>] \
  [--video-refer-type base|feature] \
  [--video-keep-sound yes|no] \
  [--poll-interval 10] \
  [--timeout 900]

参数说明

参数	必填	默认值	说明
--prompt	是	-	视频描述文本，最多 2500 字符。可用 <<<image_1>>>、<<<video_1>>> 引用图片/视频
--model	否	kling-v3-omni	模型名称，可选 kling-video-o1
--output	否	./kling_video_<ts>.mp4	输出文件路径
--aspect-ratio	条件	-	画面比例：16:9、9:16、1:1。纯文生视频时必填；有首帧图或视频编辑时不需要
--duration	否	5	时长（秒），可选 3-15。视频编辑模式下无效
--mode	否	pro	生成模式：pro（高品质）、std（标准，性价比高）
--sound	否	off	是否同时生成声音：on/off
--image	否	-	参考图片 URL（或 Base64）。可作为普通参考、首帧或尾帧
--image-type	否	-	图片帧类型：first_frame 或 end_frame，不设则为普通参考图
--image2	否	-	第二张参考图片 URL
--image2-type	否	-	第二张图片帧类型
--video	否	-	参考视频 URL（MP4/MOV，≤200MB）
--video-refer-type	否	base	视频类型：base（待编辑/指令变换）、feature（特征参考）
--video-keep-sound	否	no	是否保留视频原声：yes/no
--poll-interval	否	10	轮询间隔秒数
--timeout	否	900	最长等待秒数

常用场景

1. 文生视频

bash <skill-dir>/scripts/generate_video.sh \
  --prompt "一只猫在沙滩上奔跑" \
  --aspect-ratio "16:9" --duration 7 --mode pro

2. 图生视频（首帧）

bash <skill-dir>/scripts/generate_video.sh \
  --prompt "让画面中的人物向镜头挥手" \
  --image "https://example.com/photo.jpg" \
  --image-type first_frame --mode pro

3. 视频编辑（指令变换）

bash <skill-dir>/scripts/generate_video.sh \
  --prompt "给<<<video_1>>>中的人戴上墨镜" \
  --video "https://example.com/input.mp4" \
  --video-refer-type base --video-keep-sound yes

4. 视频参考（生成下一个镜头）

bash <skill-dir>/scripts/generate_video.sh \
  --prompt "基于<<<video_1>>>，生成下一个镜头" \
  --video "https://example.com/input.mp4" \
  --video-refer-type feature --aspect-ratio "16:9" --duration 5

注意事项

• 环境变量 HSAI_API_KEY 必须设置；依赖 curl 和 python3
• 视频生成耗时较长（通常 3-10 分钟），脚本会自动轮询等待
• 如果用户未指定 prompt，先向用户询问要生成什么内容的视频
• 如果用户提供的描述比较简短，可以帮助扩展为更详细的 prompt
• 有参考视频时，--sound 只能为 off
• 视频编辑模式（--video-refer-type base）下，输出视频时长与输入视频相同，--duration 和 --aspect-ratio 无效
• 视频生成完成后，告知用户文件路径，询问是否需要移动/复制