AI电商上架套图
把已核实的商品照片和 SKU 信息整理为一个有顺序的上架图片组,包括主图、卖点、细节、场景、尺寸或包装信息。每张图都必须持续呈现同一个经确认的 SKU、事实和品牌方向。
主图合规与辅图说服分开。只需要一张干净背景图、一张场景图,或针对单张商品图的定向修改时,转交 product-photo-studio;卖家只想核对单张主图是否符合某个站点的规则,或只要一次定向修复时,转交 marketplace-main-image-preflight。本包适合为一个 SKU 制作统一的多图上架组。模特上身图,以及长图详情或 A+ 视觉模块,都不在本包这一个 SKU 的图片组范围内——在选定并安装对应的专门包之前,不要在本包里做这两类工作。
先确认输入与图片计划
硬输入是真实商品照片和已确认的 SKU 事实。缺事实不编造卖点图。收集商品照片、SKU 名称与型号、颜色、材质、尺寸、包装清单、已确认卖点、禁止改变的标识,以及目标站点和图片位。不能从用户材料证实的事实不要写入图片。宿主看不到的图片,按卖家声明的用途处理,不要声称自己已经看过;上传只是把素材交给 Beatra,并不等于已经查看。先出有序镜头表(主图、卖点、场景、尺寸、包装),等卖家确认计划,再按张付费出图。先给出图片顺序、每张图的目的、需保留的细节、短文案边界与选用画布;卖家确认后才进入付费制作。
一组图只覆盖一个已核实的 SKU。卖家有颜色、尺寸或材质变体时,以随图提供的那个变体领衔,放进整组确认里一并确认,不必先问;只有照片里不止一个变体、卖家又没有说明时才问哪个领衔。要在同一组里加一张展示全系列的图,需要卖家另外提供一张真正同时包含全部变体的照片,不能把几张单独的照片拼起来当作一张全系列图。由卖家在任何付费调用之前选择:在领衔那组里加一张全系列图,还是每个变体各做一组。多个 SKU 就是多轮制作,之间共用槽位模板和视觉方向,绝不共用事实卡。详见上架图片组工作流(references/workflow.md)。
逐张制作
准备槽位卡、选择路线或写请求载荷之前,先读上架图片组工作流(references/workflow.md)。再次发现只需针对单张主图检查站点要求时,转交 marketplace-main-image-preflight。需要重新构建同一商品的画面时使用 beatra.images.transform,并将经过确认的商品图放在 images[0];需要对已有成图做局部更正时使用 beatra.images.edit。为模型、画布、控制项或价格作决定前查询 beatra.models.list。默认使用 model 为 auto、每个任务 count 为 1,并为每个逻辑请求分配唯一不透明的 client_request_id。每张图片保持 count: 1,在交付中记录 billing.net_charged_credits。
只在单张有明确局部问题且卖家批准时再使用 beatra.images.edit;仍把已确认商品图放在 images[0]。立刻保存返回的 task_id,以 beatra.tasks.get 跟踪到终态。若响应或任务标识丢失,先以 beatra.tasks.list 查找候选并用 beatra.tasks.get 确认;仅应卖家要求取消,且不替换已经进入执行的原任务时使用 beatra.tasks.cancel。
只使用随包 scripts/mcp_client.py 进行上传和远程调用。工具名称通过 call 传入,JSON 通过标准输入发送;不要配置或调用宿主 Beatra Connector,也不要使用 REST/OpenAPI 降级或回退。以下示例只展示命令形态,实际内容必须替换为卖家已批准的信息:
printf '%s' '{"capability":"image_to_image"}' | python3 scripts/mcp_client.py call beatra.models.list
printf '%s' '{"images":[{"type":"artifact","artifact_id":"sku-front"}],"prompt":"Create the approved product-hero slot. Preserve the verified SKU shape, colour, label, and included items.","canvas":{"type":"preset","tier":"2K","aspect":"1:1"},"count":1,"client_request_id":"opaque-sku-hero-id"}' | python3 scripts/mcp_client.py call beatra.images.transform
审阅、恢复与资料
规划阶段不收费。第一次付费调用之前,只出示一次整组确认,冻结完整的有序槽位表、每张图的提示词、底图与参考图的顺序、已批准的事实来源、每个槽位的画布、模型行为、出图数量、当前每张单价,以及总价上限和总调用次数;这次确认还要说明中途停下时卖家已经拿到什么,以及余额在中途用尽时那份已冻结的计划会怎样。卖家批准这一次之后才开始付费出图。收到结果后,检查商品形状、颜色、标签、随附物、事实一致性、图片顺序和画布适配。缓慢任务仍是同一任务;只可对相同的请求标识重放丢失的创建响应,任何已批准槽位、事实来源、底图与参考图顺序、画布、模型、出图数量或控制项的变化,均是新付费请求并需重新批准。
- 图片组计划、槽位顺序、变体分流、提示词写法、请求载荷、确认卡、任务恢复与图片组复核,以及查询剩余积分和这一趟扣了多少:上架图片组工作流(references/workflow.md)
- 第一次制作,或整组图看起来不像同一套时:一整套上架图片组的完整示例(references/worked-example.md)
- 出图不对、任务变慢、响应丢失或批准后要改动时:常见问题与反模式(references/faq.md)
- 首次安装或授权失效:安装与授权(references/installation-and-auth.md)
- 不收费的包安装注册:安装注册(references/installation-registration.md)
- 任务轮询、产物和结果字段:任务与结果(references/tasks-and-results.md)
- 余额、校验和结构化错误:计费、错误与恢复(references/billing-errors-and-recovery.md)
- 随包客户端连接诊断:随包 MCP Client 连接诊断(references/mcp-connection.md)
- 更新保证和控制:自动更新与安全(references/automatic-updates-and-safety.md)
- 移除本包或共享凭据:卸载与断开连接(references/uninstall-and-disconnect.md)
运行时和安全自动更新
随包客户端在每个安装中静默检查更新,每 24 小时最多一次。发现更高版本时,会不另行确认自动安装。只从当前包、渠道和语言环境的固定官方发现地址与不可变 Beatra CDN 路径下载,并在替换前校验发现数据、压缩包、清单和每个文件;只替换本包拥有的文件。任何检查、下载、替换或回滚失败时,当前安装保持可用,用户原本请求的命令继续执行。更新失败不会重试已付费的图片生成,设置在本安装中持续生效。
python3 scripts/mcp_client.py update --auto off
python3 scripts/mcp_client.py update --auto on
python3 scripts/mcp_client.py update --check
完整的官方来源、完整性校验、替换范围与恢复说明见自动更新与安全(references/automatic-updates-and-safety.md)。
微信扫一扫