用途
GooseWorks Product Photos 是一个商品摄影技能,目标是把品牌已有的商品图片加工成可发布的摄影成品,涵盖干净的棚拍、生活场景以及模特上身效果,并在整个过程中保持商品本身的真实外观。它的核心价值在于丰富品牌可用的商品图像素材:经批准的照片会加入品牌素材库,并可进一步供广告工作流(goose-ads)使用。
主要能力
- 一次提交即可完成后端全流程:编写拍摄提示词、在 gpt_image_2 上生成、对商品还原度进行评判,并免费自动重试若干次,最后保存结果。
- 支持按类别预设场景与构图:category 可选 apparel(服饰)、beauty(美妆)、cpg(快消品)。
- 支持通过 prompt 在预设设置之上追加自由文本引导,但不替代预设设置。
- 支持指定数量(1、2、4 或 8)与质量(low、medium、high,默认 medium)。
- 支持引用参考图片 URL。
- 支持模特出镜(需用户明确同意并传入 attestation_accepted: true)。
- 提供成本预估、生成轮询、结果列表、批准与归档等配套工具。
使用方式
前置条件:必须安装 GooseWorks MCP 服务器。所有操作都通过 mcp__gooseworks__* 工具完成;如果这些工具不可用,应停止并提示用户运行 gooseworks install --claude --mcp(并重启 Claude Code)。没有 HTTP 或文件回退方案。
身份与额度:一个 agent 作用域令牌用于认证工具,工具会自动解析所属组织,令牌不应被打印。额度由后端处理:generate_product_photos 会预先预留预估费用,只对通过评判的照片计费;自动重试免费;评判无法通过(flagged)的照片会展示但不计费。可先调用 estimate_product_photos 获取报价,用 get_ad_credits 查看余额。
选择品牌与商品:
- list_ad_brands:获取用户的广告品牌(得到 brand_id,也带有 slug)。
- list_brand_products { brand_id, search?, page?, page_size? }:列出品牌已导入的商品,选择 product_id 进行拍摄;search 匹配名称、类型、变体或 SKU。
- import_product { brand_id, kind, url, product_name? }:导入尚未在目录中的商品。kind 可为 product_url(单个商品页)、shopify_store(店铺 URL,导入整个目录)或 image_url(直接图片,需提供 product_name)。返回带 id 的导入记录;若状态不是 complete,则轮询 get_product_import 直到完成,再用 list_brand_products 找到新商品。MCP 不支持文件上传,需使用 URL。
- get_product_import { import_id }:轮询导入直到状态为 complete 或 failed。
生成:
- estimate_product_photos { count, quality? }:成本预览(单张与总积分),不预留任何额度。
- generate_product_photos { brand_id, product_id, variant_id?, category, controls?, prompt?, count?, quality?, reference_image_urls?, attestation_accepted? }:执行生成。省略 controls 则使用类别预设;prompt 作为自由文本引导叠加在设置之上。立即返回带 id 的生成记录,随后轮询 get_product_photo_generation 直到完成,再读取每个 outputs[].final_image_url。若请求模特出镜(controls.model.presence 不为 none),必须传入 attestation_accepted: true 以确认用户拥有模特图像的权利。
- get_product_photo_generation { generation_id }:轮询直到状态为 complete、partial_failure 或 failed。每个 outputs[] 条目有各自状态,就绪后带有 final_image_url。flagged 的输出是最佳尝试但未计费。
使用结果:
- list_product_photos { brand_id, archived? }:列出品牌已生成的照片(archived: false 为活跃,true 为已归档)。
- approve_product_photo { output_id }:批准照片,将其关联到商品并使其在品牌素材库中可用,从而供 goose-ads 使用。照片在批准前不会被任何地方使用。
- archive_product_photo { output_id, reason? }:归档照片;已归档照片会被排除在广告生成之外。
适用场景
- 为品牌商品补充可发布的棚拍、生活场景或模特上身照片。
- 需要保持商品真实外观、避免虚构材质、配色或轮廓的摄影任务。
- 希望将批准后的照片接入广告工作流(goose-ads)的品牌。
- 已有品牌上下文(voice、positioning、audience、logo、颜色、字体)并希望直接复用、无需反复询问用户的场景。
限制
- 必须安装 GooseWorks MCP 服务器,且只能通过 mcp__gooseworks__* 工具使用,没有 HTTP 或文件回退方案。
- MCP 不支持文件上传,导入商品需使用 URL。
- 不得虚构商品事实;后端基于商品真实图片进行拍摄,不应描述看不到的商品。
- 应使用品牌上下文而非反复询问用户;只需询问拍摄类别、数量、质量以及模特同意。
- 花费前需先报价并确认数量与质量,因为 generate_product_photos 会预留额度。
- 生成中应轮询而非重复提交,重复提交会重复计费;只有失败的生成才应重试。
- 模特图像需要用户同意,仅在用户要求时设置,并传入 attestation_accepted: true。
- 只有批准的照片才会进入品牌素材库与广告工作流,已归档的永远不会进入。
- 关于具体收费金额、价格、平台覆盖范围或效果数据,资料中暂未提供。