product-video-ads

name	product-video-ads
description	根据商品图片自动生成专业广告视频；包含商品扣图、信息识别、脚本创作、分镜设计、视频生成和后期合成全流程；适用于商品推广、电商营销、品牌宣传等场景
dependency	{"python":["rembg==2.0.50","moviepy==1.0.3","Pillow==10.0.0"]}

商品广告视频生成器

任务目标

• 本 Skill 用于：将商品图片自动转化为专业广告视频
• 能力包含：商品主体扣图、商品信息识别、广告脚本创作、分镜设计、视频生成、TTS配音、BGM配乐、视频拼接合成
• 触发条件：用户上传商品图片并请求生成广告视频

整体流程说明

• 第四阶段：视频生成 → 第五阶段：TTS配音生成 → 第六阶段：BGM选择 → 第七阶段：后期合成
• 🔴 强制步骤顺序：
  1. 先完成步骤9-10（视频片段生成和收集）
  2. 再完成步骤7（TTS配音生成）
  3. 最后完成步骤11（视频拼接与音频合成）
• 🔴🔴🔴 核心原则：
  • 视频生成和TTS生成是完全独立的两条线，互不干扰
  • 视频生成只使用视觉元素（画面、运镜、打光），绝对不包含任何台词
  • TTS生成只使用脚本台词，绝对不包含任何视觉描述
  • 两步必须各自完成，最后在步骤11合并

前置准备

• 依赖说明：scripts脚本所需的依赖包及版本

  rembg==2.0.50
  moviepy==1.0.3
  Pillow==10.0.0
  

• 非标准文件/文件夹准备：如果Skill执行过程中需要使用除「Skill固定结构」外的文件或文件夹，需前置创建。当前路径视为相对于Skill目录的父目录

  # 创建临时输出目录
  mkdir -p temp_output/videos
  mkdir -p temp_output/audio
  mkdir -p temp_output/final
  

操作步骤

整体流程说明

核心原则：视频画面生成和TTS配音生成是完全独立的两条线

视频画面生成线：
步骤4（脚本创作）→ 步骤5（分镜设计）→ 步骤6（视频Prompt）
→ 步骤9（生成视频片段）→ 步骤10（视频收集）
→ 步骤11（拼接视频）

TTS配音生成线（独立进行）：
步骤4（脚本创作）→ 步骤7（TTS配音生成）
→ 步骤11（添加TTS到视频）

两线汇合：
步骤11（视频拼接与音频合成）= 拼接好的视频 + 整段TTS音频 + BGM → 最终广告视频

关键要点：

• 视频生成Prompt只包含视觉元素（画面、运镜、打光、商品、场景），不包含任何台词
• TTS生成基于完整脚本的整段台词，不包含任何视觉描述
• 两步完全独立，互不干扰，最后在步骤11合并

第一阶段：商品处理与信息识别

步骤1：商品主体扣图

• 调用 scripts/remove_background.py 处理商品图片
• 输入参数：
  • --input: 商品图片路径（如 ./product.jpg）
  • --output: 扣图输出路径（如 ./product_no_bg.png）
• 预期输出：透明背景的商品主体PNG图片

步骤2：商品信息识别

• 智能体使用视觉能力分析原图和扣图
• 识别并记录以下信息：
  • 商品类型（服装、数码、家居、食品等）
  • 主要特征（颜色、材质、设计风格）
  • 卖点信息（功能、优势、适用场景）
  • 品牌调性（高端、亲民、潮流、专业等）

步骤3：信息补充询问

• 若识别信息不足，智能体主动询问用户：
  • 目标受众（年龄、性别、消费习惯）
  • 广告时长（15s、30s、60s）
  • 视频风格（简约、时尚、科技感、温馨等）
  • 核心卖点（需重点突出的1-3个特点）

第二阶段：创意设计与脚本生成

步骤4：导演Agent创作脚本

• 智能体基于商品信息和用户需求，生成完整广告脚本
• 脚本结构包含：
  • 开场（3-5秒）：吸引注意力，展示品牌/产品概念
  • 展示（5-15秒）：多角度展示商品，突出核心卖点
  • 卖点（5-10秒）：深入讲解优势和使用场景
  • 结尾（3-5秒）：品牌信息、购买引导

参考：references/script-template.md 获取标准脚本格式（含280-320字/分钟语速要求）

步骤5：分镜设计

• 智能体为脚本每个段落设计详细分镜
• 每个分镜包含：
  • 时长（秒）
  • 画面描述（构图、场景、氛围）
  • 数字人位置（左、右、居中、画外）
  • 商品展示方式（特写、全景、动态）
  • 文字提示（可选的关键文案）

参考：references/storyboard-format.md 获取分镜格式规范

步骤6：生成视频Prompt（⚠️ 重要：Prompt只包含视觉元素，不包含台词）

• ⚠️ 核心原则：
  • Prompt只包含视觉元素（画面、运镜、打光、商品、场景）
  • 绝对不包含任何台词、旁白、文字内容
  • 视频生成和TTS配音是完全独立的两步，Prompt不需要考虑台词
• ⚠️ 最高优先级：优先使用最保险的画面生成方案
  • 参考并优先使用 video-prompt-guide.md 中的"最保险的画面生成方案"章节
  • 食品类（如沙琪玛）：商品堆叠展示或工厂流水线场景，商品完全静态，只运镜
  • 数码/家居/服装等：展示台、使用场景、多角度组合，商品完全静态或自然轻微运动
  • 核心保险原则：商品完全静态，只通过运镜展示，通过多商品组合或场景丰富画面
• ⚠️ 重要警告：商品主体必须100%保持原貌
  • 绝对禁止任何形式的商品变形、扭曲、拉伸、压缩
  • 绝对禁止商品出现不可能的动态效果（如沙琪玛喷牛奶、饼干喷彩带等）
  • 绝对禁止改变商品的形状、结构、包装外观
  • 设计核心：通过运镜、打光、场景来增强展示，而不是改变商品本身
• 运镜类型说明：
  • 往前推（Push In）：突出商品细节，从整体到局部
  • 旋转运镜（Rotation）：展示商品360度视角
  • 平移运镜（Pan）：横向或纵向展示多个商品或场景
  • 环绕运镜（Orbit）：围绕商品中心，展示立体感
  • 静止镜头（Static）：商品完全静态展示（最保险）
• 严格按照商品特征分析框架进行分析：
  • 基础属性：商品类型、颜色、材质、尺寸、重量
  • 主体形状和结构（最高优先级）：几何形状、包装外观、结构特点
  • 设计风格：设计语言、细节程度、线条风格
  • 功能属性：核心功能、使用场景、适用人群
  • 品牌调性：档次定位、情感基调、价值观
• 参考 video-prompt-guide.md 生成符合商品特征的Prompt：
  • 优先使用"最保险的画面生成方案"章节中的方案
  • 根据"禁止的动态效果"章节，绝对避免喷洒、变形、喷发等诡异效果
  • 根据商品类型选择最保险的展示方案（商品堆叠、工厂流水线、展示台等）
  • 确保商品完全静态，只通过运镜展示
  • 遵循Prompt约束清单，商品主体一致性检查为最高优先级
  • 确保自然真实、符合商品特性、符合品牌调性
• 执行Prompt质量校验：
  • 商品主体一致性检查（最高优先级）：确认商品外观与扣图100%一致，无任何变形
  • 保险性检查：是否使用了最保险的画面生成方案
  • 自然性检查：商品运动自然流畅（或完全静态），质感匹配
  • 一致性检查：风格统一、特征一致、调性贯穿
  • 适用性检查：场景合理、卖点突出、受众共鸣
  • 专业性检查：画面质量、构图专业、色彩协调
• Prompt要素（仅视觉元素）：
  • 商品主体描述（基于扣图，强调与扣图100%一致，不包含台词）
  • 场景环境描述（符合商品实际使用场景或最保险的展示场景，不包含台词）
  • 数字人形象与动作（仅视觉描述，不包含台词）
  • 摄像机运镜（自然流畅，推荐：往前推、旋转、平移、环绕、静止）
  • 灯光与色调（符合商品材质和品牌调性，通过打光增强展示）
  • 整体风格关键词（2-3个核心词汇，保持一致性）
  • 必须声明："product's shape, structure, and appearance remain exactly as shown in reference"

第四阶段：视频生成（强制完成后再进行下一步）

步骤9：并行生成视频片段（🔴 强制步骤：必须完成此步骤才能进行步骤7）

• 为每个分镜调用 scripts/generate_video.py 生成视频片段
• 🔴 强制要求：必须完成所有视频片段的生成，生成结果确认无误后，才能进入步骤7（TTS配音生成）
• 输入参数：
  • --prompt: 分镜的视频生成Prompt（仅包含视觉元素，不包含台词）
  • --product-image: 商品扣图路径
  • --duration: 分镜时长（秒）
  • --output: 视频片段输出路径
  • --api-key: 视频生成API密钥（从环境变量读取）
  • --api-url: 视频生成API端点
• 预期输出：按分镜顺序生成的视频片段（MP4格式）
• 确认完成标志：所有视频片段已生成并验证质量后，才能进入步骤7

步骤10：视频片段收集

• 智能体收集所有生成的视频片段
• 按分镜顺序整理为列表
• 检查视频质量（分辨率、时长、稳定性）
• 🔴 强制要求：确认所有视频片段已就绪后，才能进入步骤7

第五阶段：TTS配音生成（必须在视频生成完成后进行）

步骤7：TTS配音生成（🔴🔴🔴 最高优先级：必须在步骤9和10完成之后进行）

• 🔴🔴🔴 强制时机要求：
  • 必须在步骤9（视频片段生成）和步骤10（视频片段收集）完全完成后，才能开始此步骤
  • 绝对禁止：在视频片段生成之前或同时进行TTS生成
  • 绝对禁止：将视频生成的视觉描述和TTS的台词混在一起
• 🔴🔴🔴 独立性强制要求：
  • TTS生成只能基于完整广告脚本的整段台词
  • TTS生成绝对禁止包含任何视觉描述、画面信息、分镜信息
  • TTS生成绝对禁止参考或使用任何视频生成的内容
  • TTS生成和视频生成是完全隔离的两步，没有任何信息交流
• 生成方式（强制要求）：
  • ⚠️ 必须基于完整脚本的整段台词一次性生成单个TTS音频文件
  • ❌ 绝对禁止：按分镜分段生成TTS，再拼接成整段文件（这会导致语速不均匀、片段之间跳转）
  • ❌ 绝对禁止：将视频生成的视觉描述和TTS的台词混在一起
  • ✅ 正确做法：将整个脚本的所有台词合并为一段，一次性生成TTS
• 语速要求：
  • 快速语速：280-320字/分钟
  • 整段TTS保持均匀一致的语速，不允许忽快忽慢
  • 确保旁白连续流畅，不存在片段之间跳转或重复的问题
• 选择标准：
  • 语音风格（专业女声、亲切男声、活力青年等，符合品牌调性）
  • 情感表达（热情、专业、温馨等，与广告氛围匹配）
• 生成要求：
  • 根据脚本的完整台词生成单个TTS音频文件（一次性生成，非分段拼接）
  • 音频时长应与视频总时长匹配（±1秒）
  • 语音清晰自然，语速均匀一致
• 输出格式：WAV或MP3，保存为单个文件（如 ./temp_output/audio/narration.wav）
• 确认完成标志：TTS音频文件生成完成并验证后，才能进入步骤11

第六阶段：BGM选择（在视频生成和TTS都完成后进行）

• 🔴 强制时机要求：
  • 必须在步骤7（TTS配音生成）完成后进行
  • 推荐在步骤11之前准备BGM
• 智能体根据视频风格推荐BGM类型：
  • 轻快活泼（适合年轻、潮流产品）
  • 专业沉稳（适合商务、科技产品）
  • 温馨抒情（适合家居、母婴产品）
  • 节奏感强（适合运动、数码产品）
• 用户选择：
  • 从 assets/bgm/ 库中选取（如果可用）
  • 或提供自己的BGM文件

第七阶段：后期合成（必须在视频生成和TTS都完成后进行）

第四阶段：视频生成（强制完成后再进行下一步）

步骤9：并行生成视频片段（🔴 强制步骤：必须完成此步骤才能进行步骤7）

• 为每个分镜调用 scripts/generate_video.py 生成视频片段
• 🔴 强制要求：必须完成所有视频片段的生成，生成结果确认无误后，才能进入步骤7（TTS配音生成）
• 输入参数：
  • --prompt: 分镜的视频生成Prompt（仅包含视觉元素，不包含台词）
  • --product-image: 商品扣图路径
  • --duration: 分镜时长（秒）
  • --output: 视频片段输出路径
  • --api-key: 视频生成API密钥（从环境变量读取）
  • --api-url: 视频生成API端点
• 预期输出：按分镜顺序生成的视频片段（MP4格式）
• 确认完成标志：所有视频片段已生成并验证质量后，才能进入步骤7

步骤10：视频片段收集

• 智能体收集所有生成的视频片段
• 按分镜顺序整理为列表
• 检查视频质量（分辨率、时长、稳定性）
• 🔴 强制要求：确认所有视频片段已就绪后，才能进入步骤7

第五阶段：TTS配音生成（必须在视频生成完成后进行）

步骤7：TTS配音生成（🔴🔴🔴 最高优先级：必须在步骤9和10完成之后进行）

• 🔴🔴🔴 强制时机要求：
  • 必须在步骤9（视频片段生成）和步骤10（视频片段收集）完全完成后，才能开始此步骤
  • 绝对禁止：在视频片段生成之前或同时进行TTS生成
  • 绝对禁止：将视频生成的视觉描述和TTS的台词混在一起
• 🔴🔴🔴 独立性强制要求：
  • TTS生成只能基于完整广告脚本的整段台词
  • TTS生成绝对禁止包含任何视觉描述、画面信息、分镜信息
  • TTS生成绝对禁止参考或使用任何视频生成的内容
  • TTS生成和视频生成是完全隔离的两步，没有任何信息交流
• 生成方式（强制要求）：
  • ⚠️ 必须基于完整脚本的整段台词一次性生成单个TTS音频文件
  • ❌ 绝对禁止：按分镜分段生成TTS，再拼接成整段文件（这会导致语速不均匀、片段之间跳转）
  • ❌ 绝对禁止：将视频生成的视觉描述和TTS的台词混在一起
  • ✅ 正确做法：将整个脚本的所有台词合并为一段，一次性生成TTS
• 语速要求：
  • 快速语速：280-320字/分钟
  • 整段TTS保持均匀一致的语速，不允许忽快忽慢
  • 确保旁白连续流畅，不存在片段之间跳转或重复的问题
• 选择标准：
  • 语音风格（专业女声、亲切男声、活力青年等，符合品牌调性）
  • 情感表达（热情、专业、温馨等，与广告氛围匹配）
• 生成要求：
  • 根据脚本的完整台词生成单个TTS音频文件（一次性生成，非分段拼接）
  • 音频时长应与视频总时长匹配（±1秒）
  • 语音清晰自然，语速均匀一致
• 输出格式：WAV或MP3，保存为单个文件（如 ./temp_output/audio/narration.wav）
• 确认完成标志：TTS音频文件生成完成并验证后，才能进入步骤11

第六阶段：音频设计

• 调用 scripts/merge_video.py 进行视频拼接和音频合成
• 输入参数：
  • --video-segments: 视频片段列表（JSON格式）
  • --tts-audio: TTS音频文件路径（单个整段音频文件）
  • --bgm: BGM文件路径（可选）
  • --output: 最终视频输出路径
  • --bgm-volume: BGM音量（0.1-1.0，默认0.3）
• 处理内容：
  • 按顺序拼接所有视频片段
  • 将整段TTS配音添加到拼接后的视频
  • 如果TTS音频时长与视频不匹配，自动循环或截断
  • 叠加BGM背景音乐
  • 调整音频混音平衡（TTS人声清晰，BGM作为背景）
• 预期输出：完整广告视频（含整段TTS配音和BGM）

步骤12：质量检查与交付

• 智能体检查最终视频：
  • 视频流畅度（转场是否自然）
  • 音画同步（TTS与画面匹配）
  • 音频清晰度（人声与BGM平衡）
  • 整体时长是否符合要求
• 向用户展示预览链接或下载地址

资源索引

• 必要脚本：
  • scripts/remove_background.py（用途：商品主体扣图；参数：input图片路径、output输出路径）
  • scripts/generate_video.py（用途：调用视频生成API生成分镜视频；参数：prompt、product-image、duration、output、api-key、api-url）
  • scripts/merge_video.py（用途：视频拼接和音频合成；参数：video-segments、tts-audio单个文件、bgm、output、bgm-volume）
• 领域参考：
  • references/script-template.md（何时读取：步骤4创作脚本时，参考标准脚本格式和台词字数规范）
  • references/storyboard-format.md（何时读取：步骤5设计分镜时，参考分镜格式规范）
  • references/video-prompt-guide.md（何时读取：步骤6生成Prompt时，严格参考商品特征分析框架和约束清单）
• 输出资产：
  • assets/bgm/（直接用于：BGM素材库，按风格分类存储）

注意事项

• 仅在需要时读取参考，保持上下文简洁
• 当操作脆弱或需强一致性时，优先调用脚本执行并进行结果校验
• 充分利用智能体的语言理解和生成能力，避免为简单任务编写脚本
• 视频生成API的调用需要用户配置密钥，智能体需指导用户如何设置环境变量
• BGM文件是可选资源，如果没有预置BGM，可让用户提供自己的音乐文件

使用示例

示例1：15秒数码产品广告

• 功能说明：生成一款智能手表的15秒推广视频
• 执行方式：智能体主导创意设计，脚本负责技术处理
• 关键参数：
  • 商品图片：./smartwatch.jpg
  • 广告时长：15秒
  • 视频风格：科技感、专业
  • 目标受众：25-35岁职场人士
• 执行流程：
  1. 扣图并识别手表特征
  2. 生成脚本（开场：科技感氛围 → 展示：多角度外观 → 卖点：健康监测功能 → 结尾：品牌Slogan）
  3. 设计3-4个分镜
  4. 选择专业女声TTS，节奏感强的BGM
  5. 生成视频片段并拼接

示例2：30秒时尚服装广告

• 功能说明：生成一款春装连衣裙的30秒推广视频
• 执行方式：智能体主导创意，脚本处理技术细节
• 关键参数：
  • 商品图片：./dress.jpg
  • 广告时长：30秒
  • 视频风格：时尚、清新
  • 目标受众：20-30岁女性
• 执行流程：
  1. 扣图并识别服装特征（颜色、款式、面料）
  2. 生成脚本（开场：春日氛围 → 展示：模特试穿效果 → 卖点：舒适透气、百搭 → 结尾：购买引导）
  3. 设计5-6个分镜（包含人物动态）
  4. 选择亲切女声TTS，轻快BGM
  5. 生成视频片段并拼接

示例3：60秒家居产品广告

• 功能说明：生成一款智能扫地机器人的60秒推广视频
• 执行方式：智能体主导全流程，脚本辅助处理
• 关键参数：
  • 商品图片：./robot_vacuum.jpg
  • 广告时长：60秒
  • 视频风格：温馨、科技
  • 目标受众：家庭用户
• 执行流程：
  1. 扣图并识别产品功能点
  2. 生成脚本（开场：家庭场景 → 展示：产品外观与操作 → 卖点：智能路径、静音运行 → 应用场景：不同家庭环境 → 结尾：优惠信息）
  3. 设计8-10个分镜
  4. 选择专业男声TTS，温馨BGM
  5. 生成视频片段并拼接