higgsfield-product-photoshoot

产品拍摄

通过 higgsfield product-photoshoot create 命令生成品牌图片。CLI 会调用后端提示词增强器，其中包含特定模式的摄影词汇和结构模板，然后提交给 gpt_image_2 并返回图片 URL。

步骤 0 — 初始化

执行任何其他命令之前：

1. 如果 $PATH 中没有 higgsfield，请安装：

   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 标志保持英文。
3. 提交前最多询问 4 个简短问题。使用带标签的选项，不要使用开放式问题。
4. 如果答案可从上下文（已上传的图片、之前的对话、品牌记忆）中明确得知，则跳过该问题。
5. 绝不自行编写 gpt_image_2 提示词——由后端生成。
6. 静默轮询。等待 URL 就绪后再提供。

模式

模式	用户需求……
product_shot	中性／影棚／目录风格背景上的产品
lifestyle_scene	真实环境、手部、动作、氛围中的产品
closeup_product_with_person	紧密裁切的画面，包含手部／部分面部——美妆使用、手持、演示
moodboard_pin	竖版 2:3 Pinterest 原生美学，情绪板风格
hero_banner	宽幅网站／邮件／营销活动页眉
social_carousel	3–10 张相互关联的 IG / LinkedIn / Facebook 幻灯片
ad_creative_pack	为 Meta / TikTok / Pinterest / Google Ads 制作的协调静态广告变体套装
virtual_model_tryout	AI 渲染的模特穿戴或使用产品
conceptual_product	超现实／CGI 风格／悬浮／飞溅／雕塑感的产品
restyle	转变现有图片的美学、氛围或季节背景

模式选择

根据意图选择，而非表面关键词。如果两个模式都适用，优先选择更具体的模式。

• 产品 + 中性／干净／白色／影棚／目录／Shopify → product_shot
• 产品 + 场景／使用中／厨房／户外／咖啡馆／健身房 → lifestyle_scene
• 手持产品／面部与产品同框／美妆使用／演示 → closeup_product_with_person
• Pinterest、pin、竖版 pin → moodboard_pin
• hero、横幅、网站页眉、落地页、邮件页眉、宽幅格式 → hero_banner
• 轮播、幻灯片帖子、多页幻灯片、可滑动内容 → social_carousel
• 广告、广告套装、付费社交、Meta / TikTok / Pinterest 广告 → ad_creative_pack
• 模特穿戴、虚拟试穿、上身展示、时尚拍摄、造型册 → virtual_model_tryout
• 悬浮、漂浮、飞溅、定格动作、超现实、CGI、雕塑感 → conceptual_product
• 修改现有图片的美学、氛围、季节——不改变主体 → restyle

优先级判断：

• “我的产品放在厨房台面上的 Pinterest pin” → moodboard_pin（Pinterest 是发布平台）
• “展示我的产品使用场景的 hero banner” → hero_banner（横幅格式优先）
• “展示我的产品在不同场景中的轮播内容” → social_carousel（多页幻灯片优先）
• “人物涂抹精华液的特写” → closeup_product_with_person（具体类型优先）

生成前访谈

提交前询问 3–4 个简短问题。始终提供带标签的选项，不要使用开放式问题。如果答案可从上下文中明确得知，则跳过该问题。

类型 A — 已上传产品照片，并要求“帮我制作图片／产品拍摄图”

1. 要几张？[1 / 3 / 5]
2. 想要什么风格／氛围？[干净影棚 / 生活方式 / 概念风格 / 加入模特 / 其他]
3. 用在哪里？[Shopify / Instagram / Pinterest / 付费广告 / 网站主视觉]
4. 要匹配哪些品牌色？（如可明确得知，则跳过）

类型 B — 上传了产品照片，并指定了使用场景

例如：“为我的产品制作广告”“制作 Pinterest Pin”“制作主视觉横幅”。模式显而易见。只询问缺少的信息：

1. 需要多少张？（仅适用于多图输出模式）
2. 优惠内容、氛围或吸引点是什么？
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 <mode> \
  --prompt "<short user-intent description from interview answers>" \
  [--image <path-or-upload-id>]... \
  [--count <1-10>] \
  [--aspect_ratio <override>]

示例：

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 moodboard_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。

分辨率

所有产品拍摄任务均使用 2k。

交付结果

以简短的项目符号列表输出图片 URL。不要输出 JSON、ID、内部模型名称或增强后的提示词文本。如果任务失败，简要说明失败状态。

3 lifestyle shots ready:
- 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 值。