refvideo-product-gen 使用说明书

参考视频 → 反推提示词 → 代入你的商品 → 生成「同款」AI 视频 · 基于 Agnes Video V2.0 API
类型 视频生成 / 参考视频仿制
输入 1 条参考短视频(链接或本地)+ 商品图(公网 URL 或本地)+ 卖点 + Agnes API Key
输出 1 条比例 / 时长 / 镜头语言与参考视频一致、主角换成你商品的 AI 视频(可选加字幕 + BGM)
触发词 参考这条短视频给我做个同款 / 反推这条视频的提示词再换成我的商品 / 照这个视频的比例时长生成带我产品的视频

一、你该对我说什么(人话示例)

你不用懂任何参数。把参考视频丢给我、告诉我卖什么、把商品图发我(最好是能直接打开的公网链接),剩下的我来做。生成前我会把「反推出来的模板」和「最终提示词」都给你过目,你点头我才动手。

二、工作流程总览(阶段 0–5,确认点不可跳过)

阶段环节谁来做落地脚本
0接收参考视频(本地 / 直链 / 平台分享链接)你提供—
1抽帧 + 探测比例时长 + 可选转录 → 反推提示词骨架自动extract_frames.py
2收集商品图 + 卖点 + 是否保留原文案你提供—
3代入商品拼最终提示词(必须你确认)我起草,你拍板—
4调 Agnes 创建任务并轮询下载(需 API Key)需你给 Keygenerate_video.py / retry_poll.py
5加字幕 + 背景音乐(确认原片后做)你选 BGM / 文案add_subtitle_bgm.py
💡 核心思路:先把一条「好看的现成视频」拆成模板(镜头、光线、风格、比例、时长),只把主角换成你的商品,所以成片看起来就是「同款」。

三、实战范例(照抄即可用)

场景

你有一条抖音竖屏视频:一个陶瓷咖啡杯在厨房台面上缓缓旋转。你想换成自己的不锈钢保温杯,比例 / 时长 / 镜头跟原视频一模一样,最后加一句卖点字幕和一段轻音乐。

第 1 步:分析参考视频,反推模板(自动)

python "/skills/refvideo-product-gen/scripts/extract_frames.py" ^
       --input "参考视频.mp4" --output-dir ./ref_analysis --num-frames 10 --transcribe

脚本会:定位 / 下载视频 → ffprobe 探测比例与时长 → 均匀抽 10 帧 →(可选)Whisper 转录口播。输出 JSON 摘要,含 ratio、mapped_num_frames、mapped_frame_rate、帧图路径、转录文案。我逐帧看图后,按「八维度」(主体/动作/场景/镜头/光线/风格/比例/时长)写出反推骨架 reference_prompt 给你看。

这一步结束我会说:「我拆出这条视频的模板了:9:16 竖屏、约 5 秒、缓慢环绕镜头、暖色晨光、电影感。下面给你看反推骨架。」

第 2 步:告诉我商品信息(你提供)

你只需说:「商品是不锈钢保温杯,卖点:一键开盖、1L 大容量、保温 12 小时。商品图给你公网链接 https://xxx/cup.png。原视频没有口播,不用保留文案。」

第 3 步:代入商品,确认最终提示词(必须你点头)

我按模板把主体换成保温杯,给你完整展示:生成模式(有公网图 → ti2vid 图生视频,外观更保真)、最终 prompt、反向提示词(必含 subtitles, captions, watermark, logo text)、宽高 / 帧数 / 帧率(严格沿用第 1 步探测值)。确认后才会消耗 API 额度开始生成。

第 4 步:生成视频(需你给 Agnes API Key)

python "/skills/refvideo-product-gen/scripts/generate_video.py" ^
       --prompt "The stainless tumbler performs a slow elegant rotation on a wooden kitchen counter, warm morning sunlight, smooth cinematic orbit shot, cozy lifestyle advertisement style" ^
       --image "https://xxx/cup.png" --mode ti2vid ^
       --width 768 --height 1152 --num-frames 121 --frame-rate 24 ^
       --negative-prompt "subtitles, captions, text overlay, watermark, logo text, blurry, distorted hands" ^
       --api-key "你的Agnes Key" --output-dir ./output

脚本自动轮询并下载成片到 output/ecom_video_<id>.mp4,同时保存 <id>.json 元数据。生成的无字幕原片先给你预览。

⚠️ 轮询 403 拦截(本机实测): 创建任务正常,但 GET /agnesapi 轮询常被 Cloudflare 返回 403。遇到时别反复重试——先记下脚本打印的 video_id,换网络 / 开 VPN 后跑:
python "/skills/refvideo-product-gen/scripts/retry_poll.py" --from-file output/ecom_video_<id>.json
或让你去 Agnes 官网后台直接下载。

第 5 步:加字幕 + 背景音乐(确认原片后做)

你选 BGM:上传一段音频 / 指定本地 BGM 目录让我挑 / 用默认 E:/背景音乐1.MP3;字幕文案给一句卖点即可。我烧字幕 + 混音输出 final_product_video.mp4。
python "/skills/refvideo-product-gen/scripts/add_subtitle_bgm.py" ^
       --input output/ecom_video_<id>.mp4 ^
       --subtitle-text "一键开盖,1L大容量,保温12小时" ^
       --bgm "E:/背景音乐1.MP3" --bgm-volume 0.3 ^
       --output output/final_product_video.mp4

四、常用参数速查

比例 → 分辨率

比例widthheight适用
9:167681152竖版短视频(抖音/快手/视频号/Reels)
16:91152768横版演示
1:1768768方形信息流
4:31024768传统横版
3:47681024竖版产品展示

时长 → 帧数 / 帧率

时长num_framesframe_rate
~3s8124
~5s12124
~10s24124
~18s44124
~29s44115
~37s44112

num_frames 必须 <=441 且满足 8n+1(81/121/241/441),否则 API 返回 400。

五、⚠️ 必读提醒

分阶段确认不能省: 反推展示 → 商品信息 → 提示词确认 → 生成 → 加字幕/BGM,任一步都要你拍板;生成后必须先看原片,再说要不要加字幕。

六、环境与路径(本机已验证)

依赖本机状态
ffmpeg / ffprobe7.1,已在 PATH ✓(抽帧 / 烧字幕 / 混音依赖)
requests已装在隔离 venv(2.34.2)✓
Whisper(转录,可选)未装则跳过转录并提示,不影响抽帧
yt-dlp(平台链接下载,可选)未装则提示你把视频下到本机再上传
脚本位置/skills/refvideo-product-gen/scripts/
📌 一句话总结:丢一条参考视频 + 你的商品图给我,我拆模板、换主角、严格同比例同时长生成;你全程只需在三个确认点点头,最后可选加字幕和 BGM。生成前必看反推骨架与最终提示词。
← 返回 SKILL 库