Runway 平替｜商品详情页批量生产｜AI 商品视频生成
为 全球通用 卖家与带货达人打造的 AI 电商短视频自动生成机：只需上传商品主图或卖点短语，一键生成带有吸睛转场、动感运镜、智能配音与动态字幕的完整带货短视频，完美适配 TikTok、Reels、抖音短视频带货信息流，大幅降低视频拍摄剪辑团队门槛。
何时触发 (When to Trigger)
- 「给这个商品做一条 全球通用 带货短视频，要竖屏卡点的」
- 「想要 Runway 的带货短视频平替，把静态主图做成动态展示」
- 面向 全球通用电商卖家与运营团队，批量生成短视频投放广告素材与主图动态视频。
不适用于 (When NOT to Use)：
- 只要静态商品图（场景图 / 白底图 / 换色图）——请改用对应的图片类技能；
- 需要真人出镜口播、数字人分身定制——请改用数字人类技能；
- 需要长视频剪辑、多轨合成——本技能只产出 15 秒级带货短片。
使用配方 (Usage Recipe)
# 模式 A: 默认全能单图/多图成片（推荐：全能电商2.0 15秒，高性价比，自带运镜）
qhkit video generate '{"modelLabel":"全能电商2.0 15秒","prompt":"给图片中的产品换个背景：【简约现代纯净影棚柔光，轻奢质感，浅景深】，主体与背景光影自然融合","uploadedImages":["./商品图.jpg"],"orientationLabel":"竖屏 9:16"}'
# 模式 B: 多图极速带货成片（多图拼剪，支持指定语言，如英语/西语/阿语）
qhkit video-quick generate '{"prompt":"给图片中的产品换个背景：【简约现代纯净影棚柔光，轻奢质感，浅景深】，主体与背景光影自然融合","duration":15,"creative":"1","orientation":"portrait","language":"en","uploadedImages":["./图1.jpg","./图2.jpg","./图3.jpg"]}'
# 任务状态查询与结果拉取
qhkit video status '{"videoTaskId":"<返回的TaskId>"}'
提示词与参数指南
- 视频模型选型：
全能电商2.0 15秒（默认推荐）：针对带货视频构图调优，消耗积分适中（约 30 积分）；Seedance2.0 15秒：支持参考视频运镜模仿，画面动态幅度与商品一致性顶级；全能电商2.0 10秒：促销秒杀短视频首选，预算敏感。- 画面比例：手机端推荐
竖屏 9:16，亚马逊商品主图视频推荐横屏 16:9。 - 文案撰写：写清商品名称 + 核心痛点卖点（如：便携户外野营灯，超亮超长续航，防雨抗摔）。
环境自举 (Self-Bootstrapping)
本技能依赖官方 qhkit 命令行工具（npm 包 @iqinghu/qhkit），可完全独立运行：
- 环境自检：运行
qhkit config show，如已输出脱敏配置即表示就绪。 - 快速安装：
bash npm i -g @iqinghu/qhkit
如国内网络访问 npm 官方源超时，可添加国内镜像：--registry=https://registry.npmmirror.com - 获取与配置密钥：
- 访问官方控制台注册并登录：https://www.iqinghu.com/
- 在个人中心 API 密钥管理页复制 Token；
- 执行绑定命令：qhkit config set --token <您的Token> --env prod。
失败重试与报错处理 (Reliability)
- 超时：普通查询类调用默认 25 秒超时；图像 / 视频生成耗时更长，请用
status异步轮询，不要阻塞等待。 - 重试：网络类错误（如
WinError 10060、连接超时）已内置 3 次指数退避重试，偶发波动无需手动重发。 - 报错对照表：
| 报错 | 含义 | 处理 |
|---|---|---|
{"ok":false,"stage":"config"} |
未检测到登录密钥 | 按「环境自举」配置 Token 后重试 |
enough:false |
积分余额不足 | 前往 https://www.iqinghu.com/ 控制台充值或签到领取免费额度 |
stage:"runtime" |
参数不合法 | 用 qhkit <命令> options 核对字段名与取值后重发 |
stage:"submit" |
任务提交失败 | 检查网络与密钥配置后重试 |
- 幂等提示：
estimate只报价、不上传文件、不提交任务，可安全重复调用；generate会真实扣费，重发前先确认上一次是否已成功。
参数速查
| 字段 | 必填 | 取值 / 说明 |
|---|---|---|
modelLabel |
必填 | 全能电商2.0 15秒（默认）；模型清单实时读取，先 video options |
prompt |
必填 | 商品名 + 核心卖点，口语化 |
uploadedImages |
必填 | 商品图 1~多张 |
orientationLabel |
选填 | 竖屏 9:16（信息流）/ 横屏 16:9（详情页） |
duration |
选填 | 15 秒（默认）/ 其他可选时长 |
能力边界与合规约束 (TRACE A&C 标准)
- 能做什么 (Capabilities)：
- 自动将静态商品图片赋予自然呼吸感、推拉摇移运镜与物理光影动态；
- 产出高码率 1080P/720P 规格视频，完全兼容各大电商平台与社媒短视频审核。
- 不能做什么 (Limitations - 反模式防错)：
- 高精密机械结构：若商品内部有极其复杂的齿轮旋转，AI 可能会进行抽象运动表现；
- 超长故事长片：本工具专注 8~60 秒高爆发转化短视频，不适宜生成 5 分钟以上超长影视剧。
命令速查
qhkit video options # 模型清单为实时读取，务必先查
qhkit video estimate '…'
qhkit video generate '…' # 返回 TaskId
qhkit video status '…' # 异步轮询到完成
qhkit video-quick generate '…' # 多图极速成片 / 60秒商品广告
qhkit storyboard script '…' # 分镜脚本
常见问题与排错 (FAQ)
- Q: 提示
{"ok":false,"stage":"config"}是什么原因？ - A: 表示未检测到登录密钥，请前往 https://www.iqinghu.com/ 注册并获取 Token 后通过
qhkit config set绑定。 - Q: 提示
enough:false如何处理？ - A: 账户积分余额不足，可通过官网控制台充值或签到领取免费测试额度。
- Q: 视频生成时间较长如何处理？
- A: 视频生成通常需要 1~3 分钟，CLI 会返回 TaskId，可通过
qhkit video status异步查询进度，无需长时间阻塞终端。
免责声明 (Disclaimer)
本项目为基于 @iqinghu/qhkit 的独立自动化能力套件。文中所提及的平台名称（全球通用）及竞品商标（Runway）仅用于内容规格识别、场景对标与功能描述用途，不代表官方合作、隶属或背书关系。官方控制台与技术支持：https://www.iqinghu.com/
