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

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

使用方式#

bash

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

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

2. 图生视频（首帧）#

bash

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

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

bash

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

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 无效
• 视频生成完成后，告知用户文件路径，询问是否需要移动/复制