批量生成详情页
说明如何读取多个商品文件夹,逐款批量生成电商详情图并按指定宽度保存结果,适合女装、鞋包等批量上新场景和统一规则的详情页制作。
这个功能能解决什么问题
批量生成详情页 用来给一批商品逐款生成电商详情图。
你把每个商品分别放在一个子文件夹里,再选择这些子文件夹共同所在的商品根目录。系统会按款式读取参考图,逐款生成详情页前 5 张图,并按你选择的宽度保存到各自商品文件夹中。
它适合女装、鞋包等以商品展示、核心卖点和简洁营销为主的类目,尤其适合一批上新商品使用同一套生成规则的场景。
它和“AI生成详情页”有什么区别
两个页面处理的是同类需求,但使用方式不同:
AI生成详情页:上传一款商品的 1 张或多张图片,适合单款查看效果、修改方案和精细处理。批量生成详情页:选择包含多个商品子文件夹的根目录,适合多款商品按同一套规则连续处理。
第一次处理新类目或新风格时,建议先用 AI生成详情页 做一款小样本。确认效果合适后,再到本页面批量生成。
使用前要准备什么
1. 准备商品根目录
每个直接子文件夹代表一个商品或一个款式。例如:
2026秋季上新
├─ 款式A
│ ├─ 01.jpg
│ ├─ 02.jpg
│ ├─ 03.jpg
│ └─ 04.jpg
├─ 款式B
│ ├─ 01.jpg
│ ├─ 02.jpg
│ └─ 03.jpg
└─ 款式C
├─ 01.jpg
├─ 02.jpg
└─ 03.jpg在页面上选择的是最外层的 2026秋季上新,不是单独某一款商品文件夹。
所选商品根目录是第1层,商品文件夹是第2层。参考图片直接放在商品文件夹内时位于第3层;继续放进主图、原图等素材子文件夹时位于第4层或更深层。本功能会在每个商品文件夹内部递归查找可用参考图,并排除明显不适合作为商品参考图的结果目录和素材。
2. 每款至少准备 1 张可用参考图
当前固定 5 图详情版支持每款使用 1 到 5 张参考图,建议准备 3 到 5 张清晰且能互相补充的图片,例如:
- 商品正面或整体图。
- 背面图。
- 模特上身图。
- 面料、工艺或局部细节图。
- 能看清版型、颜色和使用场景的图片。
不要把尺码表、条形码、吊牌、白底图或其它商品图片混进参考图。系统会排除一部分明显不适合的图片,但整理清楚的素材仍然更稳定。
3. 同一批商品尽量属于相近类目
补充提示词和生成方案会作用于整批商品。外套、连衣裙、鞋子和箱包等差异很大的商品,建议分批处理。
页面设置说明
商品根目录
选择包含多个款式子文件夹的目录。系统按直接子文件夹逐款处理;如果目录下没有子文件夹,则会把当前目录本身当作一款商品。
每款上传图片
这个设置决定每个商品文件夹里哪些图片参与生成:
全部:读取可用图片,并按当前生成方案允许的最大数量取图。固定 5 图详情版最多取 5 张。前几张:按图片名称排序后,读取前面指定数量的图片。后几张:按图片名称排序后,读取后面指定数量的图片。
如果文件夹内图片较多,建议先整理文件名,再选择前几张或后几张。
生成方案
生成方案决定详情图的结构和内容方向。页面会自动读取管理员当前启用的详情生成版本,不需要用户填写服务地址或其它技术参数。
当前默认使用 固定5图详情版,通常会生成:
- 首屏价值图。
- 核心卖点图。
- 材质结构图。
- 场景体验图。
- 规格收尾图。
管理员以后增加或调整生成版本后,页面中的选项会同步更新。
详情页宽度
至少选择一种输出宽度:
750宽790宽1440宽
在线生成只执行一次,生成成功后再在本地按所选宽度输出图片。选择多个宽度不会重复发起同一款的在线生成,但会产生多套不同宽度的结果文件。
设置模板
设置模板用来保存经常复用的批量规则,例如生成方案、每款取图方式、排序、宽度、处理范围、并行数、重试次数和补充提示词。
保存模板:覆盖当前下拉框选中的模板。另存为模板:保留当前模板,并新增一个可在下拉框中选择的模板。
模板不会保存本次商品根目录,也不会保存“确认使用在线生成额度”的勾选状态。下次仍需重新选择目录并确认。
处理范围
全部商品:处理根目录下所有商品子文件夹。仅处理缺少详情的商品:如果商品文件夹内已有名称包含“详情”的目录,并且里面已有图片,则保留该商品并跳过生成。
如果你只想给缺少详情图的商品补齐素材,选择第二项可以避免重复处理。
已有结果处理
保留并另存:已有同名结果不会被覆盖,新结果会使用新的文件名保存。替换同名结果:覆盖详情页目录中同名的宽度结果图,不会删除目录,也不会覆盖原始参考图。
不确定时建议选择 保留并另存。
图片排序
图片排序决定“前几张”和“后几张”的读取顺序:
名称从低到高名称从高到低
建议使用 01.jpg、02.jpg、03.jpg 这样的文件名。这样每款商品的取图顺序更容易预测。
参考图选择方式
页面提供三种方式:
使用已整理图片:按文件夹和图片名称读取已准备好的素材。本地智能筛选:根据图片尺寸、画面比例、文件大小和目录位置进行本地筛选,不使用在线视觉识别。AI视觉优选素材:候选图较多时自动挑选更适合参与生成的商品图;当前更适合服装、鞋包类。
使用 AI视觉优选素材时,候选图不超过 5 张会直接使用现有候选图;达到 6 张及以上才会进行在线优选。
检查目录 只统计普通候选图数量、缺图商品和跳过原因,不会提前执行 AI视觉优选。选择 AI视觉优选素材 时,正式生成阶段才会按上面的数量条件执行在线优选。因此,检查结果表示“有哪些候选素材”,不表示 AI 已经选出了正式参考图。
并行数
并行数表示同时处理多少款商品,可设置 1 到 4。
1:逐款处理,最稳妥。2:适合小批量和较稳定的网络环境。3-4:速度更快,但会同时上传和生成多款商品,对网络与在线生成服务要求更高。
第一次使用建议设置为 1 或 2。并行执行完成后,任务结果仍按商品文件夹原顺序展示,不会因为完成先后而打乱列表。
失败重试次数
单款生成失败后,系统会按设置自动重试。当前可设置 0 到 3 次。
网络波动、服务临时超时或没有取得可保存图片时,重试可能有效。缺少参考图、服务额度不足等持续性问题,需要先解决原因,反复重试通常不会成功。
补充提示词
用于补充这一批商品共同的卖点、风格和禁写要求。例如:
突出秋冬通勤、小个子友好和利落版型;不要夸大面料成分。补充提示词会作用于整批商品。如果某一款有完全不同的要求,建议把它单独处理。
在线生成额度确认
开始批量生成前,必须勾选 我确认开始后会使用在线生成额度。没有勾选时,系统不会提交生成任务。
检查目录 不会正式生成图片,也不消耗详情图生成次数。
如果参考图选择方式为 AI视觉优选素材,并且某款候选图达到 6 张及以上,正式运行还会先执行一次在线图片优选。图片优选和详情图生成是两个不同的在线处理步骤,会分别记录相应使用量;候选图不超过 5 张时不会调用在线图片优选。
推荐操作流程
- 先用
AI生成详情页测试一款商品。 - 把同一类商品整理到一个商品根目录,每款一个子文件夹。
- 每款准备 3 到 5 张清晰参考图。
- 选择商品根目录。
- 选择生成方案、输出宽度和参考图选择方式。
- 选择处理范围与已有结果处理方式。
- 点击
检查目录。 - 到任务中心查看商品数量、普通候选图数量、缺图商品和跳过原因。选择 AI视觉优选时,这一步还没有执行正式优选。
- 根据检查结果修正素材或设置。
- 选择并行数和失败重试次数。
- 勾选在线生成额度确认。
- 点击
开始批量生成。 - 在任务中心查看实时进度、部分失败原因和最终结果。
正式处理整批商品前,建议先用 2 到 5 款做小批量验证。
本功能按商品文件夹和图片运行,不读取商品表格,因此不需要 Excel 或 CSV 模板。
结果保存在哪里
每款商品的结果保存在该商品文件夹下的 详情页 目录中。
批量处理时,详情页目录位于第3层,生成的具体详情图片位于第4层。原始参考图不会被移动或删除。
常见结构:
款式A
└─ 详情页
├─ 原始生成图
│ ├─ A01_首屏价值图.jpg
│ ├─ A02_核心卖点图.jpg
│ └─ ...
├─ 750宽_A01_首屏价值图.jpg
├─ 750宽_A02_核心卖点图.jpg
├─ 790宽_A01_首屏价值图.jpg
└─ ...如果选择了三个宽度,一张原始生成图会对应三张不同宽度的结果图。
任务完成后,还可以从 生成历史记录 查看本批商品的成功、部分成功、失败数量和结果缩略图。
怎样理解“成功、部分成功、失败”
成功:当前商品需要的结果都已取得并保存。部分成功:当前商品至少保存了一张结果图,但还有部分图片下载或保存失败。失败:当前商品没有取得可保存的详情图,或在上传、生成、下载过程中完全失败。
部分成功不会被当作全成功隐藏。任务中心和生成历史会单独显示,方便你只处理缺失部分。
常见问题
为什么点击开始后立即提示缺少宽度
至少要选择一种详情页宽度。宽度全部取消时,页面和后端都会阻止任务启动,避免消耗额度后没有正式输出图。
为什么有的商品被跳过
如果处理范围选择了 仅处理缺少详情的商品,系统发现该商品已有详情目录和图片时会跳过。需要重新生成时,请改为 全部商品。
为什么有的款成功,有的款失败
批量任务按商品分别记录结果。常见原因包括:
- 某个商品文件夹没有可用参考图。
- 参考图损坏、格式异常或内容混乱。
- 在线生成服务额度不足。
- 在线生成服务暂时不可用。
- 网络连接中断或服务超时。
- 结果已返回,但图片下载或本地保存失败。
先查看任务中心中的具体商品和失败原因,不要因为一款失败就重复提交整批。
在线生成服务额度不足时会怎样
任务通常会在在线生成阶段失败,页面不会得到可保存的详情图。任务中心会显示服务不可用、额度不足或服务返回异常等提示。
遇到这种情况,先停止扩大批量,稍后重试或联系管理员/客服确认在线生成服务状态。
每款应该放多少张图片
固定 5 图详情版支持 1 到 5 张,建议 3 到 5 张。图片之间要能补充商品信息,不要放大量重复角度。
并行数是不是越高越好
不是。并行数越高,同时进行的上传和生成越多。第一次使用建议 1 或 2,确认稳定后再逐步增加。
失败重试设置多少合适
通常设置 1 次即可。持续失败时应查看原因,不建议无条件提高到 3 次反复消耗等待时间。
批量生成会删除或覆盖原始参考图吗
不会删除原始参考图。替换同名结果 只影响详情页目录里的同名宽度结果图,不会清空商品目录。
云店Agent可以怎样帮助你
你可以这样问云店Agent:
这批商品适合用批量生成详情页吗?每款图片很多,我应该选本地智能筛选还是AI视觉优选素材?帮我解释这次批量任务里部分成功的原因。为什么有几款没有生成详情图?云店Agent会优先查阅本文档和任务中心记录。涉及正式生成和额度消耗时,仍会要求你确认后再执行。
