Agent Skill

商品图

将真实产品照片制作成影棚级电商主图、场景图或面向市场平台的高清商品图。这款 AI 商品图工作室用于商品图片处理和电商图片编辑,可替换背景、改善光效、搭建场景。它以原图中的商品外观特征为依据,从一张手机随拍就能做出白底主图、生活场景图和高级广告图。适用于亚马逊白底产品图、淘宝主图、Shopify 产品大图和社交媒体商品图。从一张产品照片出发,组合多张参考图,或在选定草稿上做定向精修,完成适合上架使用的成品;生活场景图和广告图也能直接用作商品详情页图片。

商业运营·AI音乐人·来自 skill_hub·skillhub.cn ↗
skillhub install @user_87b8e34f/product-photo-studio
13 Stars·15.3万 综合热度·3,378 字文档·源站更新 2026-11-22

README 文档

3,378 字

AI商品图工作室

将一张真实产品照片转化为影棚级上架图、生活场景图或面向市场平台的主视觉。复用对话中已经明确的决定,沿最短路径完成用户需要的商品图。

选择制作路线

  • 纯净背景: 有一张产品照片时,移除原始背景,将产品放在纯白、浅灰或影棚渐变背景上,使用 beatra.images.transform。这是平台主图的默认选择。
  • 场景与生活化: 有一张产品照片和场景描述时,将产品放入真实使用场景——厨房台面、木桌、大理石层架或季节背景——使用 beatra.images.transform。
  • 精修选定草稿: 使用 beatra.images.edit,把选定图片作为 images[0],修复阴影、去除反光、调整色温或清理小瑕疵,不改变整体构图。

精确路线参见产品路由(references/product-routing.md),把需求转化为以源产品为依据的视觉规格时参见场景工艺(references/scene-craft.md)。

形成一份产品简报

硬输入是一张真实商品照片。场景和光效不得改写已确认的颜色、配件或数量。

复用用户已经给出的产品类型、目标平台、背景偏好和风格参考。只有缺失决定会实质改变结果时才询问。标准平台主图优先建议纯白背景;生活场景请求优先建议匹配产品品类的场景。

简报围绕以下内容展开:

  • 产品本身——它是什么、品类,以及关键外观细节(标签文字、品牌标识、形状、颜色);
  • 一个目标平台或用途(亚马逊、淘宝、Shopify、社交媒体、广告投放),当它决定格式指引时;
  • 一个背景或场景方向(纯白底、影棚渐变、生活场景、季节主题);
  • 有序视觉参考(风格灵感、背景参考、角度参考),产品照片始终在第一位。

用户已经说明目标平台或背景类型时直接复用。确实缺少这项决定时,给出最合适的默认建议,并把它合并进一次付费调用确认。

准备调用

所有远程 MCP 操作只能使用本 Skill 随包 scripts/mcp_client.py。工具名称作为 CLI 参数,工具参数以 JSON 通过标准输入传入。不要配置或调用宿主 Beatra Connector,也不要使用 REST/OpenAPI 作为回退。精确命令和排错参见随包 MCP Client 连接诊断(references/mcp-connection.md)。

  • 先通过随包客户端辅助命令上传产品照片,再调用 beatra.images.transform,把上传的 artifact 作为第一个有序参考。在 prompt 中显式标注产品图的角色,让模型以源图和已确认的商品细节为视觉依据。
  • 纯净背景时,设置正方形或平台要求的画布比例。
  • 生活场景时,在 prompt 中描述场景、光照方向和表面材质,同时列出应延续到结果中的商品外观特征。
  • 精修选定草稿时,调用 beatra.images.edit。局部修改最多使用两个归一化 editregions,指定 imageindex=0;全图调整则省略区域。

上传只让远程工具取得文件字节,本身不等于图片检查。只复查宿主确实能够看到的视觉事实。

除非用户明确选择其他设置,否则保持 model=auto 和 count=1。只有模型、可用性、兼容性或价格确实影响决定时才调用 beatra.models.list。完整请求结构与示例参见工作流(references/workflow.md)。

确认并只执行一次

策划和简报准备免费。付费图片调用前,展示并固定最终提示词、有序参考图、画布、背景或场景方向、模型、控制项和输出数量。仍然缺失的高影响决定应合并到这一次确认中。

获得确认后,为这一个精确的逻辑请求创建一个稳定且不透明的 clientrequestid,并只提交一次。提示词、参考图或顺序、画布、场景方向、模型、数量或控制项任一变化,都是新的付费工作,需要新的确认和新标识符。

跟进、复查与交付

收到 taskid 后,只用 beatra.tasks.get 轮询该任务。如果标识符丢失,使用 beatra.tasks.list 查找候选并用 tasks.get 验证选中项。只有原始响应状态确实未知时,才能用完全相同的参数和同一个 clientrequest_id 进行幂等恢复。轮询缓慢、更新失败、授权失败或连接失败都不能创建替代性付费任务。

只有在用户主动要求时才使用 beatra.tasks.cancel。取消返回 409 时,继续跟踪原任务。完整恢复合同参见复查与恢复(references/review-and-recovery.md)。

结果可见时,依次对照源图复查产品保真度、背景质量(边缘干净、光照一致、阴影自然)、颜色准确性、画布适配,以及目标平台的当前图片指引。交付 artifact 链接、实际尺寸、任务标识符和 billing.netchargedcredits。最多提供一次聚焦的、未执行的精修建议。生成的素材也可以在 www.beatra.cn 查看和管理。

工具返回积分不足时:把工具返回的原文整段交给用户,链接一个字不改。其余可以译成中文。不要改写成自己的充值说明。引导用户按原文去充值。

用户问还剩多少积分时,调用 beatra.wallet.get。问扣了什么时,调用 beatra.wallet.ledger。两者只读。不要发明账户余额或充值工具。不要把 wallet.get 当成每次付费提交前的必做步骤。

按任务查阅参考文档

  • 在纯净背景、生活场景和精修编辑之间选择,或针对特定平台规划:产品路由(references/product-routing.md)
  • 把需求转化为以源产品为依据的场景规格:场景工艺(references/scene-craft.md)
  • 每条路由的精确请求结构、有序参考标注和 JSON 示例:工作流(references/workflow.md)
  • 遗失任务、轮询缓慢、取消、结果复查或规划精修:复查与恢复(references/review-and-recovery.md)
  • 首次安装或认证过期:安装与认证(references/installation-and-auth.md)
  • 随包 MCP Client 命令与诊断:随包 MCP Client 连接诊断(references/mcp-connection.md)
  • 安装注册:安装注册(references/installation-registration.md)
  • 任务查询、轮询与结果字段:任务与结果(references/tasks-and-results.md)
  • 余额、校验与结构化错误:计费、错误与恢复(references/billing-errors-and-recovery.md)
  • 断开安装连接:卸载与断开(references/uninstall-and-disconnect.md)
  • 更新与安全:更新与安全(references/updates-and-security.md)

安装与账号操作

首次使用和共享操作参见安装与认证(references/installation-and-auth.md)、安装注册(references/installation-registration.md)、任务与结果(references/tasks-and-results.md)、计费、错误与恢复(references/billing-errors-and-recovery.md)以及卸载与断开(references/uninstall-and-disconnect.md)。

更新与安全

本 Skill 会自动更新。内置客户端每天最多一次从 Beatra 官网读取本渠道的版本信息 (中国大陆网络走 www.beatra.cn 与 cdn.beatra.cn)。有新版本时,它下载官方发布包, 逐个文件校验 SHA-256,再替换本 Skill 自己的文件;你放进这个目录的其他文件不会被 改动。替换过程中断时,下次运行会自动恢复到替换前的状态。除此之外,它不下载或执行 任何其他代码,只通过 HTTPS 与 Beatra 官方服务通信;你选择上传的文件只会传到 Beatra 为这次上传签发的一次性地址。

关闭自动更新:python3 scripts/mcp_client.py update --auto off。关闭后,客户端每天 最多提示一次在你安装它的商店里更新的命令。详见更新与安全(references/updates-and-security.md)。

同分类其他技能

查看全部 ›