marketer-ad-variant-factory

广告变体工厂

将一个已批准的创意扩展为 10-30 个可投放的广告变体，用于在 Meta、Google、TikTok 和 Pinterest 上进行 A/B 测试。专为快速批量生成和直接上传到广告账户而设计（采用确定性命名）。

适用场景

• 用户已有主视觉创意，需要围绕标题 × 视觉 × CTA × 背景生成大量变体，以进行 A/B 测试。
• “为这个 Meta 广告生成 30 个变体”/“生成测试矩阵”/“扩展这个创意”。
• 正在准备投放新的广告组——需要 9:16、1:1、16:9 规格，每种规格搭配 3-5 个视觉变体。
• 不要用于单个主视觉（使用 gen-ai generate），也不要用于跨渠道创意（使用 marketer-campaign-kit）。此技能用于深入探索单个创意，而非拓展多个渠道。

前置条件

如果简报未涵盖以下信息，请事先询问（合并为一条消息）：

1. 主视觉素材 — 已批准创意图片的路径或 URL。
2. 变化维度 — 视觉方向（1-5）、背景/场景（1-5）、主体构图（特写还是广角），可选：色彩处理。
3. 平台/纵横比 — Meta 需要 9:16 + 1:1，TikTok 使用 9:16，展示广告需要 16:9。确认具体需求。
4. 变体数量 — 总共需要多少个？首次测试通常为 10-15 个，大范围探索则为 30 个以上。
5. 命名规范 — 广告平台要求怎样的格式（例如 {campaign}_{axis}_{variant}_{size}.webp）？
6. 品牌限制 — 颜色（hex）、禁止元素、是否已有 brand.md？

如果用户只说“多来一些”，默认生成 5 种视觉 × 3 种纵横比 = 15 个变体。

运行方法

1. 以主视觉为基准。 主视觉是参考图片——每个变体都应像它的同系列作品，而非风格迥异的作品。如果主视觉保存在本地，请先上传到 Drive，以便后续任务引用 URL。
2. 定义变体矩阵。 明确列出各个变化维度。5 种视觉方向 × 3 种纵横比 = 15 个任务。不要混用 8 种变化维度——这样会让测试结果难以解读。
3. 编写清单。 每个变体对应一个任务，并使用唯一的 id，使其符合广告平台的命名规范。image 字段引用主视觉。
4. 估算并试运行。

   gen-ai batch run variants.json --dry-run
   

5. 将并发数设为 6-8。 图片变体生成速度快且彼此独立——将并发数调高至默认值 3 以上。留意 429 错误；如果出现，则降至 4。

   gen-ai batch run variants.json -c 8 -o ./ad-variants
   

6. 检查并恢复。 筛选 results.json 中未完成的任务，并重试。

   gen-ai batch resume ./ad-variants
   

7. 交付。 广告平台上传工具需要包含标准命名文件的平铺文件夹——results.json 包含每个文件的路径和 URL，可直接导入 Meta Ads Manager / TikTok Ads / Google Ads 的 CSV。

快速参考

命名规范 {campaign}_{visual}_{composition}_{size} 可确保后续上传整洁有序。

{
  "defaults": {
    "model": "recraftv4",
    "negativePrompt": "low quality, watermark, busy background",
    "imageUrls": ["https://cdn-pipeline-output.picsart.com/.../hero.webp"]
  },
  "jobs": [
    { "id": "launch_bright_closeup_9x16", "prompt": "bright daylight variant, close-up focal, warm tones", "aspectRatio": "9:16" },
    { "id": "launch_bright_closeup_1x1",  "prompt": "bright daylight variant, close-up focal, warm tones", "aspectRatio": "1:1"  },
    { "id": "launch_bright_closeup_16x9", "prompt": "bright daylight variant, close-up focal, warm tones", "aspectRatio": "16:9" },
    { "id": "launch_studio_wide_9x16",    "prompt": "studio lighting, wide shot, neutral backdrop",        "aspectRatio": "9:16" },
    { "id": "launch_studio_wide_1x1",     "prompt": "studio lighting, wide shot, neutral backdrop",        "aspectRatio": "1:1"  },
    { "id": "launch_studio_wide_16x9",    "prompt": "studio lighting, wide shot, neutral backdrop",        "aspectRatio": "16:9" },
    { "id": "launch_urban_medium_9x16",   "prompt": "urban street setting, medium shot, cinematic",        "aspectRatio": "9:16" },
    { "id": "launch_urban_medium_1x1",    "prompt": "urban street setting, medium shot, cinematic",        "aspectRatio": "1:1"  },
    { "id": "launch_urban_medium_16x9",   "prompt": "urban street setting, medium shot, cinematic",        "aspectRatio": "16:9" }
  ]
}

由 3 种视觉 × 3 种纵横比生成 9 个变体。添加视觉行即可扩展到 15 或 30 个。注意：不要设置 count 字段——每个变体都要单独生成一个任务。

快速参考

子任务	模型	原因
基于主视觉生成与品牌一致的变体（默认）	recraftv4	在多次渲染中保持设计语言一致的能力最强
照片级真实感的产品/生活方式变体	flux-2-pro	写实度最佳，非常适合 Meta/TikTok 产品广告
将可读标题文字直接融入图像的变体	ideogram-v3	唯一能稳定生成清晰文案的模型——无法叠加文字时使用
在多个变体中保持人脸/角色一致	gemini-3-pro-image	Nano Banana Pro 最擅长锁定主体身份
替换固定主体的背景	gen-ai change-bg（子命令）	主体像素完全不变，只替换场景
正式生成前以极低成本探索	gemini-3.1-flash-image	成本约低 5 倍，速度快——用于筛选优胜提示词，再用 flux/recraft 重新生成

使用 gen-ai models --mode image 确认 ID。

流程

• 明确变体维度。 预先确定 3–4 个维度（视觉、构图、色彩、场景）。随意编写提示词会让 A/B 测试结果难以解读。
• 每次任务都将主视觉作为参考图。 在 defaults 中使用 image 字段——每个变体都会继承品牌风格。
• 确定性命名 = 直接导入广告平台。 {campaign}_{visual}_{composition}_{size} 可在 Meta/TikTok/Google 广告 CSV 模板中被准确解析。
• 先低成本起草，再升级优胜方案。 使用 gemini-3.1-flash-image 生成 30 个变体，花费约 $1。选出前 8 个，再用 flux-2-pro 或 recraftv4 重新生成这 8 个，作为最终上传版本。
• 为每个平台设置文字安全区。 Meta Stories 顶部预留 250px、底部预留 310px。TikTok 底部预留约 300px 给界面元素。提示词应将焦点放在画布中央 60% 的区域内。
• 图像变体的并发数设为 6–8。 图像生成速度很快——更高的并发数可在不到 2 分钟内完成 30 个变体。若遇到 429 错误，则降至 4。
• 绝不静默覆盖。 每个变体使用唯一的 id，意味着输出文件名也唯一——可以安全恢复，且不会发生冲突。
• 绝不要在提示词中声称效果。 “爆款广告，1000 万次观看”不会改善生成结果；应描述构图、主体、光线和氛围。

注意事项

• 维度过多 → A/B 测试结果难以解读。 最多变换 3–4 个维度。如果在一个变体中同时更改视觉、构图、色彩、场景和标题，就无法判断哪个方案胜出。
• 缺少主视觉参考图。 如果 defaults 中没有 image，每个变体的视觉风格都会偏离——整组素材就不像同一个广告活动。
• 宽高比与平台不匹配。 TikTok 使用 9:16 满幅，Meta Reels 使用 9:16，Meta 信息流使用 1:1 或 4:5（不再使用 1.91:1），Google Display 使用 300×250 / 728×90 / 160×600——批量生成前请先核对广告组要求。
• 图片中的文字没有本地化计划。 直接嵌入图片的文案会妨碍本地化——除非只面向一个市场，否则应将广告文案保留在广告管理器的叠加层中。
• 没有草稿阶段就一次性生成 100 个变体。 100 张按全价生成的旗舰级图片会浪费额度。先起草 → 选择 → 升级。
• 重复运行时覆盖结果。 每次运行都使用单独的输出目录（./variants-$(date +%F-%H%M)），以便顺利恢复和审计。

验证

运行 gen-ai whoami 确认身份验证正常，然后使用 --debug 重新运行失败的命令。

成本与耗时

变体数量	模型	每个变体的额度	总计	并发数为 8 时的耗时
9 个变体	recraftv4	~2	~18	~45s
15 个变体	recraftv4	~2	~30	~90s
30 个变体（探索）	gemini-3.1-flash-image	~0.5	~15	~2 min
30 个变体（旗舰）	flux-2-pro	~2	~60	~3 min
30 个草稿 + 8 个升级版	混合		~30	总计 ~4 min

始终使用 gen-ai batch run variants.json --dry-run 确认估算费用；如果估算超过用户设定的上限，请暂停。

另请参阅

• gen-ai-use/SKILL.md — 完整的 CLI 参考（标志、模型目录、身份验证）
• gen-ai-batch/SKILL.md — 清单格式、并发调优、恢复
• gen-ai-workflows/SKILL.md — 通用多步骤模式
• workflows/marketer-campaign-kit/SKILL.md — 先串联此流程，以确定主视觉和品牌风格
• workflows/marketer-localize-campaign/SKILL.md — 完成此流程后再串联，以便将优胜变体扩展到不同市场