产品摄影
通过higgsfield product-photoshoot create命令生成品牌图像。CLI调用后端提示增强器，该增强器包含特定模式的摄影词汇和结构模板，然后提交给gpt_image_2并返回图像URL。
第0步——引导
在执行任何其他命令之前：
- 如果
higgsfield不在$PATH中，请安装它：curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh - 如果
higgsfield account status失败并显示Session expired/Not authenticated，请让用户运行higgsfield auth login（交互式）并等待确认。
UX规则
- 保持简洁。在最终回复中仅打印图像URL。
- 检测语言，使用该语言回复。模式名称和CLI标志保持英文。
- 在提交前最多问4个简短问题。使用带标签的选项，永远不要开放性问题。
- 跳过那些从上下文（上传的图像、之前的轮次、品牌记忆）中显而易见的回答的问题。
- 不要自己编写gpt_image_2提示——后端会组装它。
- 轮询是静默的。等到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 | 改变现有图像的美学、情绪或季节背景 |
模式选择
根据意图而非表面关键字选择。当两种模式可能适用时，选择更具体的那种。
- product + 中性/干净/白色/工作室/目录/Shopify →
product_shot - product + 场景/使用中/厨房/户外/咖啡馆/健身房 →
lifestyle_scene - 手持/带产品的面部/美容应用/演示 →
closeup_product_with_person - Pinterest, pin, 垂直pin →
moodboard_pin - hero, banner, 网站横幅, 落地页, 邮件横幅, 宽幅 →
hero_banner - carousel, 幻灯片帖子, 多幻灯片, 可滚动 →
social_carousel - ads, ad pack, 付费社交, Meta/TikTok/Pinterest广告 →
ad_creative_pack - 模特穿着, 虚拟试穿, 在身上, 时尚拍摄, 画册 →
virtual_model_tryout - 悬浮, 漂浮, 泼溅, 冻结动作, 超现实, CGI, 雕塑型 →
conceptual_product - 修改现有图像的审美、情绪、季节——不改变主体 →
restyle
决胜规则：
- "我的产品在厨房柜台上的Pinterest pin" →
moodboard_pin(Pinterest是平台) - "展示产品使用中的英雄横幅" →
hero_banner(横幅格式优先) - "产品在不同场景中的轮播" →
social_carousel(多幻灯片优先) - "人涂抹我血清的特写" →
closeup_product_with_person(特定类型优先)
生成前访谈
在提交前问3–4个简短问题。始终用带标签的选项，不要开放性问题。跳过那些从上下文中显而易见的回答的问题。
类型A——上传了产品照片，想要"为我制作图像/摄影作品"
- 多少个？
[1 / 3 / 5] - 什么风格/情绪？
[干净工作室 / 生活方式 / 概念 / 带模特 / 其他] - 你将用在哪里？
[Shopify / Instagram / Pinterest / 付费广告 / 网站横幅] - 要匹配的品牌颜色？（如果明显则跳过）
类型B——上传了产品照片，指定了用例
例如"为我的产品制作广告"、"制作一个Pinterest pin"、"制作一个英雄横幅"。模式是明显的。只问缺失项：
- 多少个？（如果是多输出模式）
- 提供什么优惠/情绪/卖点？
- 有什么特别需要强调的吗？
类型C——仅有文本，没有产品照片
- 你能上传一张产品照片吗？（首选——保真度更高）
- 如果不能，描述产品——类别、包装、颜色、显著特征。
- 什么风格？（与类型A相同选项）
- 你将用在哪里？
类型D——上传了现有图像，想要"重做/改变氛围/不同版本"
→ restyle
- 什么审美？
[干净女孩 / 乡村风 / 安静奢华 / 黑暗学院 / Y2K / 其他] - 季节背景？
[圣诞节 / 情人节 / 万圣节 / 黑色星期五 / 无] - 要保留什么，要改变什么？（仅在不明确时）
类型E——模特穿着产品（时尚、配饰）
→ virtual_model_tryout
- 模特原型？（根据品牌受众建议2–3个）
- 环境？
[工作室干净 / 户外自然 / 街头风格 / 编辑 / 家庭温馨] - 取景？
[全身 / 四分之三 / 腰以上 / 产品区域特写]
类型F——模糊请求，不明确主题
例如"为我的品牌做些酷的东西"。
- 什么产品或主题？
- 目标？
[在市场上出售 / 建立品牌意识 / 运行付费广告 / 更新网站] - 上传参考图像？
给出答案后→返回到相关的类型A–E。
生成
单条命令。后端组装最终提示并提交给gpt_image_2。URL输出到stdout。
higgsfield product-photoshoot create \
--mode <mode> \
--prompt "来自访谈答案的简短用户意图描述" \
[--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-generateMarketing Studio。 - 不替换用于没有产品或品牌背景的原始文本到图像的
higgsfield-generate。
要避免的常见错误
- 在一条消息中问超过4个访谈问题。
- 选择错误的模式（例如，用户想要Pinterest pin时用
product_shot）。 - 直接调用
higgsfield generate create gpt_image_2 --prompt ...而不是higgsfield product-photoshoot create——绕过提示增强器，产生明显更差的输出。 - 将组装好的提示粘贴给用户——他们想要URL。
- 使用上表中不存在的
--mode值。