AI生成电商图

解决什么问题

电商运营的日常里，出图需求总是零散且格式不一：给一张商品图出一套风格统一的主图和轮播图、拼一张详情页长图、或者按一段文案出一张商业大图。不同需求对应不同的生成流程，人工切换容易选错模式、漏传参考图、参数填得五花八门。

这个技能是 LinkPix 电商图像系列的汇总入口。它把上述需求收敛到一条 qhkit image 命令上，由 Agent 先把用户的模糊表述路由到正确的模式，再按统一契约完成报价、确认、提交与交付。

如何工作

路由的关键是 modelLabel，必填、没有默认值，取值必须与 options 返回的候选值逐字一致。共两类六种：

• 固定产品模式：套图模式（一张商品图出一组风格统一的主图+轮播图，参考图或 customCopy 至少提供一个）、电商详情图（多张短图拼接的详情页长图，参考图必填且需带 themeLabel）。
• 自定义生图家族：智慧模型、图片 5.0 Pro、图片 5.0 Lite、专图模型，由 prompt 驱动（可选参考图），清单实时跟随线上目录变化。

一次完整调用的核心步骤：

• 需求路由：识别用户说的是套图、详情图还是自定义生图；只说「做电商图」这类泛需求时，先问清产物类型。
• 报价：跑 estimate 拿本次的 credits，连同张数、尺寸、画质、用到的参考图一并复述给用户。
• 确认后提交：generate 会创建任务并扣积分，等用户明确同意再执行；只读动作（options、estimate、status 等）无需确认。
• 轮询与交付：generate 自带轮询，阻塞到出图（最长约 14 分钟），产物 URL 在返回的 images 字段里，需同轮回复并附上实扣积分。

两个容易混淆的参数要分开：platform 决定套图提示词的平台适配策略（淘宝/抖音/Amazon/Shopee 等），sizePreset 只管出图尺寸。一次要处理多张图或多条提示词时，改走 image-batch，不要自己写循环逐张调。

边界与注意点

全部 6 个模式都接受参考图。用户给了商品图就传进 uploadedImages，不要只把图片内容转写成 prompt 文字——那样会丢原图细节；更不要断言「某模式不支持参考图」。

本地图单张上限 10MB，超过会被拦下。这时 Agent 应就地压缩（2048px 内等比缩小、只缩不放、输出 jpg）后用新路径重试，而不是把问题抛回用户。

调用失败时 stdout 返回 {"ok":false,"stage":"...","message":"..."}，把 message 原样转告用户即可，不要重试轰炸。

能力边界：视频类需求走「AI生成电商视频 | LinkPix」；图片压缩、加水印等本地处理走对应专项技能；音乐生成、数字人等媒体需求 qhkit 不支持，应如实告知并建议到青虎工作台确认。单一场景（换背景、抠图白底、消除、换装等）也有更聚焦的 | LinkPix 专项技能，按需选用。