产品拍摄

通过 higgsfield product-photoshoot create 命令生成品牌视觉内容。CLI 调用后端提示增强器（该模块内置特定拍摄模式的摄影术语与结构化模板），再将增强后的提示提交至 gpt_image_2，最终返回图像 URL。

第 0 步 — 初始化环境

执行其他任何命令前，请先完成以下步骤：

1. 若 higgsfield 未加入 $PATH，请安装：

   curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
   

2. 若运行 higgsfield account status 时返回 Session expired 或 Not authenticated，请提示用户运行交互式命令 higgsfield auth login，并等待其确认完成。

用户体验规范

1. 保持简洁：最终回复中仅输出图像 URL。
2. 自动识别用户语言并以该语言响应；模式名称与 CLI 参数标识符（flag）始终使用英文。
3. 提交请求前最多提出 4 个简短问题；所有问题必须提供带标签的选项（labeled options），禁止开放式提问。
4. 跳过上下文中已明确答案的问题（例如：已上传的产品图、上一轮对话内容、品牌记忆信息等）。
5. 切勿自行撰写 gpt_image_2 提示词——全部由后端组装完成。
6. 轮询过程静默进行；须等待图像 URL 就绪后一次性交付结果。

拍摄模式

模式选择原则

依据用户意图而非表面关键词选择模式；当多个模式均可能适用时，优先选用更具体的那一项。

• 产品 + 中性 / 干净 / 白色 / 影棚 / 目录 / Shopify → product_shot
• 产品 + 场景 / 正在使用 / 厨房 / 户外 / 咖啡馆 / 健身房 → lifestyle_scene
• 手持 / 面部出镜 + 产品 / 美妆应用 / 功能演示 → closeup_product_with_person
• Pinterest、pin、竖版 pin → pinterest_pin
• hero、banner、网站页首、落地页、邮件页首、宽幅 → hero_banner
• carousel、幻灯片帖文、多图滑动、可滑动 → social_carousel
• ads、ad pack、付费社交、Meta / TikTok / Pinterest 广告 → ad_creative_pack
• model wearing、virtual try-on、on body、fashion shoot、lookbook → virtual_model_tryout
• levitating、floating、splash、frozen motion、surreal、CGI、sculptural → conceptual_product
• 修改 EXISTING 图像的美学风格、情绪、季节——但不更改主体 → restyle

冲突裁决规则（tie-breakers）：

• "我的产品放在厨房台面上的 Pinterest pin" → pinterest_pin（平台属性优先）
• "展示我的产品正在使用的 hero banner" → hero_banner（格式属性优先）
• "我的产品在不同场景中的 carousel" → social_carousel（多图属性优先）
• "人物涂抹我精华液的特写" → closeup_product_with_person（类型特异性优先）

生成前访谈

提交请求前需提出 3–4 个简短问题；所有问题均须提供带标签选项，禁止开放式提问；若某问题答案已从上下文中明确，则跳过该问题。

类型 A — 已上传产品图，且请求为“为我生成图像 / 拍摄方案”

1. 需要几张？[1 / 3 / 5]
2. 期望风格/情绪？[Clean studio / Lifestyle / Conceptual / With a model / Other]
3. 将用于何处？[Shopify / Instagram / Pinterest / Paid ads / Website hero]
4. 需匹配的品牌色？（若明显则跳过）

类型 B — 已上传产品图，并指定了具体用途

例如：“为我的产品制作广告”、“制作 Pinterest pin”、“制作 hero banner”。此时模式已明确，仅需补全缺失信息：

1. 需要几张？（仅限支持多输出的模式）
2. 核心卖点 / 情绪基调 / 吸引钩子（hook）是什么？
3. 有特别需要强调的元素吗？

类型 C — 纯文本输入，无产品图

1. 能否上传一张产品图？（强烈推荐——显著提升生成质量）
2. 若无法上传，请描述产品：品类、包装、颜色、显著特征。
3. 期望风格？（选项同类型 A）
4. 将用于何处？

类型 D — 已上传现有图像，请求为“重做 / 改变氛围 / 另一版本”

→ 对应 restyle 模式

1. 目标美学风格？[Clean girl / Cottagecore / Quiet luxury / Dark academia / Y2K / Other]
2. 季节语境？[Christmas / Valentine's / Halloween / Black Friday / None]
3. 哪些元素需保留？哪些需变更？（仅当存在歧义时询问）

类型 E — 模特穿戴产品（服饰、配饰类）

→ 对应 virtual_model_tryout 模式

1. 模特原型？（根据品牌受众推荐 2–3 种）
2. 环境？[Studio clean / Outdoor natural / Street style / Editorial / Home cozy]
3. 构图？[Full body / Three-quarter / Waist up / Closeup on product area]

类型 F — 请求模糊、主体不明确

例如：“为我的品牌做个酷一点的东西”。

1. 具体是哪款产品或主题？
2. 目标？[Sell on a marketplace / Build awareness / Run paid ads / Update website]
3. 可否上传参考图？

获取回答后 → 返回对应类型 A–E 流程继续处理。

图像生成

单条命令触发完整流程。后端基于访谈结果组装最终提示词，并提交至 gpt_image_2；图像 URL 直接输出至 stdout。

higgsfield product-photoshoot create 
  --mode  
  --prompt "<基于访谈答案提炼的简短用户意图描述>" 
  [--image ]... 
  [--count <1-10>] 
  [--aspect_ratio ]

示例：

higgsfield product-photoshoot create 
  --mode lifestyle_scene 
  --prompt "bottle of cold-brew on a sunlit kitchen counter, IG feed" 
  --image bottle.jpg 
  --count 3

higgsfield product-photoshoot create 
  --mode pinterest_pin 
  --prompt "vertical pin for my candle brand, cottagecore mood" 
  --image candle.jpg

higgsfield product-photoshoot create 
  --mode restyle 
  --prompt "Christmas version, quiet-luxury aesthetic" 
  --image existing-shot.jpg

图像输入方式

--image 接受本地文件路径（自动上传）或已有上传 UUID；如需多个参考图，可重复使用该参数。

多变体生成

--count 3 将返回 3 个互不相同的图像 URL。后端会指示提示增强器在各变体间系统性地调整预设、布光、视角与配色方案——结果并非同一张图的简单改写或复刻。

对于 social_carousel 和 ad_creative_pack，--count 表示幻灯片数量或广告包内变体总数；后端将自动锁定整套视觉系统的统一性。

长宽比

后端按模式自动选取合理默认值；仅当用户明确要求其他比例时，才使用 --aspect_ratio 覆盖。允许值包括：1:1、4:5、5:4、3:4、4:3、2:3、3:2、9:16、16:9。

结果交付

以简短项目符号列表形式输出图像 URL。禁止返回 JSON、ID、内部模型名或增强后的提示文本。若某任务失败，仅需简要说明失败状态。

3 张生活方式风格图像已就绪：
- https://cdn.higgsfield.ai/.../job_abc.jpg
- https://cdn.higgsfield.ai/.../job_def.jpg
- https://cdn.higgsfield.ai/.../job_ghi.jpg

本能力不支持的功能

• 不直接编写 gpt_image_2 提示词——提示词组装完全由后端负责。
• 不自动切换图像生成模型——始终固定使用 gpt_image_2。
• 不替代 higgsfield-generate Marketing Studio 在品牌视频/虚拟形象工作流中的作用。
• 不替代 higgsfield-generate 在无产品或品牌上下文下的纯文本到图像生成能力。

常见错误规避清单

• 单次消息中提出超过 4 个访谈问题。
• 选错模式（例如：用户需求是 Pinterest pin，却误选 product_shot）。
• 直接调用 higgsfield generate create gpt_image_2 --prompt ...，而非 higgsfield product-photoshoot create——将绕过提示增强器，导致生成质量明显下降。
• 将后端组装完成的提示词原文粘贴给用户——用户只需要图像 URL。
• 使用未在上表中列出的 --mode 值。