AI 商品图工作室

技能文档

---
name: product-photo-studio
title: AI 商品图工作室
category: 内容创作
description: "将真实产品照片转化为影棚级电商主图、场景图或面向市场平台的高清商品图。这款 AI 商品图工作室可替换背景、改善光效、搭建场景，并以原图中的商品外观特征为依据——从一张手机随拍制作白底主图、生活场景图和高级广告图。适用于亚马逊白底产品图、淘宝主图、Shopify 产品大图和社交媒体商品图。从一张产品照片出发，组合多张参考图，或在选定草稿上做定向精修，完成适合上架使用的成品。"
---

# AI商品图工作室

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

## 选择制作路线

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

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

## 形成一份产品简报

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

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

简报围绕以下内容展开：

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

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

## 准备调用

所有远程 MCP 操作只能使用本技能 随包 `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`。局部修改最多使用两个归一化 `edit_regions`，指定 `image_index=0`；全图调整则省略区域。

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

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

## 确认并只执行一次

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

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

## 跟进、复查与交付

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

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

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

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

用户问还剩多少积分时，调用 `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/installation-and-auth.md)、[安装注册](references/installation-registration.md)、[任务与结果](references/tasks-and-results.md)、[计费、错误与恢复](references/billing-errors-and-recovery.md)以及[卸载与断开](references/uninstall-and-disconnect.md)。

本技能 在执行普通公开命令时，会静默检查更新，每 24 小时最多一次。发现更高版本时，会在不另行确认的情况下自动安装。更新只来自固定的 Beatra 官方发现地址和不可变 CDN 路径，并严格匹配内置的包、渠道和语言身份。替换前，客户端会校验发现文档、压缩包、清单和每个包内文件的身份、大小与 SHA-256。它只替换当前安装中本包拥有的文件。如果检查、下载、替换或回滚任一步骤失败，当前安装仍可使用，用户原本请求的命令也会继续执行。英文官方安装始终保持 `canonical/en`，SkillHub 中文安装始终保持 `skillhub/zh-CN`。

以下设置对当前安装持续生效：

```text
```


## 技能工作流

1. **需求确认**：识别用户意图，收集必要输入素材。
2. **能力路由**：按正文各章节确定所用工具与参数。
3. **执行与确认**：付费操作先向用户确认后仅提交一次。
4. **结果交付**：轮询任务至终态，如实交付产物与计费信息。

使用说明

# AI 商品图工作室

将真实产品照片转化为影棚级电商主图、场景图或高清商品图，支持换背景、改善光效、搭建场景，适用于亚马逊白底图、淘宝主图等。

## 快速开始

```text
把这张手机随拍的产品图做成白底主图和生活场景图
```

## 使用说明

详细的工作流、参数与计费说明见 SKILL.md；按任务的深入指引见 references/ 目录。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。