| name | ad-abtest |
| description | 自动生成广告素材的A/B测试变体,支持多个维度的变体生成 |
| metadata | {"openclaw":{"emoji":"🔬","requires":{"bins":["python3","ffmpeg"],"env":["ARK_API_KEY"]},"primaryEnv":"ARK_API_KEY"}} |
A/B测试变体生成 Skill
基于原始广告素材自动生成多个测试变体,支持文案、色调、运镜、时长等多个维度的变化,用于A/B测试效果对比。
使用方法
python3 scripts/generate_variants.py \
--base-video ./ad_video.mp4 \
--base-copy ./ad_copy.json \
--dimensions copy,color,motion \
--count 4 \
--output-dir ./variants
参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|
--base-video | string | ✅ | 原始广告视频路径 |
--base-copy | string | ✅ | 原始广告文案JSON路径 |
--dimensions | string | ✅ | 变体维度,多个用逗号分隔:copy/color/motion/duration/subtitle |
--count | number | | 生成的变体数量,默认4 |
--output-dir | string | | 输出目录,默认 ./variants |
--keep-original | boolean | | 是否在输出中保留原始版本,默认true |
--generate-metadata | boolean | | 是否生成变体元数据报告,默认true |
支持的变体维度
| 维度 | 说明 | 变化范围 |
|---|
copy | 文案变体 | 不同的标题、描述、CTA |
color | 色调变体 | 冷色调、暖色调、复古色调、高对比度 |
motion | 运镜变体 | 不同的镜头运动方式和速度 |
duration | 时长变体 | 7秒、10秒、15秒、30秒 |
subtitle | 字幕变体 | 不同的字幕样式、位置、内容 |
输出目录结构
variants/
├── original/ # 原始版本(可选)
│ ├── video.mp4
│ └── copy.json
├── variant_1/ # 变体1
│ ├── video.mp4
│ ├── copy.json
│ └── metadata.json
├── variant_2/ # 变体2
│ ├── video.mp4
│ ├── copy.json
│ └── metadata.json
└── variants_report.json # 变体总报告
事件发布
生成完成后会发布 variants.generated 事件到消息总线。
变体报告格式
{
"taskId": "task_123456",
"baseVideo": "./ad_video.mp4",
"dimensions": ["copy", "color"],
"count": 4,
"variants": [
{
"id": "variant_1",
"dimensions": {"copy": "variant_A", "color": "warm"},
"videoPath": "./variants/variant_1/video.mp4",
"description": "文案变体A,暖色调"
}
],
"generatedAt": "2026-03-11T12:00:00Z"
}
使用建议
- 一次测试不要超过3个维度,避免变量过多难以分析
- 变体数量建议4-6个,包含原始版本作为对照
- 测试时保持投放渠道、时间、预算一致
- 重点关注转化率、完播率、点击率等核心指标