Synthesia 平替｜场景图批量生产｜数字人讲解视频

概述

为全球通用卖家与内容团队打造的 AI 口播与数字人视频套件：上传商品图或写好的口播脚本，一键生成带数字人出镜、自然唇形同步、智能配音与高亮字幕的讲解视频，无需真人出镜、无需摄影棚与剪辑团队。

何时触发 (When to Trigger)

• 「做一条全球通用真人讲解的商品视频，但我不想出镜」
• 「这段口播视频眼神老飘，帮我矫正成看镜头」「字幕要跟读高亮」
• 「想要 Synthesia 的数字人平替，批量出多语种口播」
• 面向 全球通用电商卖家与运营团队，批量为多 SKU 产出讲解视频与多语言版本。

不适用于 (When NOT to Use)：

• 只需要商品图卡点短视频、不需要人物出镜——请改用商品短视频类技能；
• 需要真人实拍出镜——本技能产出的是数字人 / 合成口播；
• 需要长视频剪辑、多轨合成——本技能只产出 15 秒~1 分钟级口播短片；
• 需要静态商品图（场景图 / 白底图 / 换色图）——请改用对应的图片类技能。

使用配方 (Usage Recipe)

# 模式 A: 数字人口播成片（推荐，自带运镜与唇形同步）
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"]}'

# 模式 C: 从一条爆款视频反推口播脚本，再复刻成片
qhkit video-inspire generate '{"resourceUrl":"https://v.douyin.com/xxxx/"}'
qhkit video-inspire status '{"inspireTaskId":276}'   # 返回 videoScript（脚本文本）与 playVideo（直链）

# 提交前报价 + 任务状态查询
qhkit video estimate '{"modelLabel":"全能电商2.0 15秒","prompt":"给图片中的产品换个背景：【简约现代纯净影棚柔光，轻奢质感，浅景深】，主体与背景光影自然融合"}'
qhkit video status '{"videoTaskId":"<返回的 TaskId>"}'

口播脚本与参数指南

• 脚本结构：0-3 秒钩子（痛点/悬念）→ 3-10 秒产品解法与卖点 → 10-15 秒行动号召。口播文案要口语化，避免书面语长句；
• 多语种：language 参数支持 en / es / ar 等，配音与字幕会同步切换；数字人口型按目标语种适配；
• 视线矫正 / 字幕：若原片人物视线偏移，优先使用工作台对应应用处理，效果比逐帧修更稳定；
• 输出规格：竖屏 9:16 适配 TikTok / Reels / 抖音信息流，横屏 16:9 适配站内详情页。

参数速查

环境自举 (Self-Bootstrapping)

本技能依赖官方 qhkit 命令行工具（npm 包 @iqinghu/qhkit），可完全独立运行：

1. 环境自检：运行 qhkit config show，如已输出脱敏配置即表示就绪。
2. 快速安装：

   npm i -g @iqinghu/qhkit

如国内网络访问 npm 官方源超时，可添加国内镜像：--registry=https://registry.npmmirror.com

1. 获取与配置密钥：
   • 访问官方控制台注册并登录：https://www.iqinghu.com/
   • 在个人中心 API 密钥管理页复制 Token；
   • 执行绑定命令：qhkit config set --token <您的Token> --env prod。

失败重试与报错处理 (Reliability)

• 超时：普通查询类调用默认 25 秒超时；图像 / 视频生成耗时更长，请用 status 异步轮询，不要阻塞等待。
• 重试：网络类错误（如 WinError 10060、连接超时）已内置 3 次指数退避重试，偶发波动无需手动重发。
• 报错对照表：

• 幂等提示：estimate 只报价、不上传文件、不提交任务，可安全重复调用；generate 会真实扣费，重发前先确认上一次是否已成功。

能力边界与合规约束 (TRACE A&C 标准)

• 能做什么 (Capabilities)：
  • 数字人口播成片、多语种配音与高亮字幕；
  • 从爆款视频反推口播脚本并复刻；
  • 产出符合 全球通用 短视频投放规范的竖屏 / 横屏成片。
• 不能做什么 (Limitations – 反模式防错)：
  • 数字人非真人：如需真人代言效果，请使用真人素材，不要用数字人冒充真人背书；
  • 口型与语速：语速过快或含大量专业术语时，唇形同步可能出现轻微偏差；
  • 肖像与声音授权：使用真人肖像 / 声音克隆素材前，必须取得合法授权。

命令速查

qhkit video options
qhkit video estimate '…'
qhkit video generate '…'
qhkit video status '…'
qhkit video-quick generate '…'   # 多图极速口播成片（支持指定语种）
qhkit video-replace generate '…' # 角色替换 / 模特换脸
qhkit video-translate generate '…'   # 视频翻译（字幕/语音/对口型）
qhkit video-inspire generate '…'     # 从爆款视频反推口播脚本

常见问题与排错 (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 异步轮询即可，无需阻塞终端。
• Q: 数字人口型对不上怎么办？
  • A: 多为语速过快或文本含生僻术语所致，可把脚本拆成更短的句子并放慢语速后重试。

免责声明 (Disclaimer)

本项目为基于 @iqinghu/qhkit 的独立自动化能力套件。文中所提及的平台名称（全球通用）及竞品商标（Synthesia）仅用于内容规格识别、场景对标与功能描述用途，不代表官方合作、隶属或背书关系。官方控制台与技术支持：https://www.iqinghu.com/