產品攝影
透過 higgsfield product-photoshoot create 命令產生品牌圖片。CLI 會呼叫一個後端提示增強器，該增強器持有特定模式的攝影詞彙與結構化模板，然後提交給 gpt_image_2 並回傳圖片網址。
步驟 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 規則
- 保持簡潔。最終回覆只輸出圖片網址。
- 偵測語言，並以該語言回應。模式名稱和 CLI 參數保持英文。
- 提交前最多問 4 個簡短問題。使用標籤選項，絕不使用開放式問題。
- 跳過那些從上下文（上傳的圖片、先前的對話、品牌記憶）即可明顯得知答案的問題。
- 切勿自己撰寫 gpt_image_2 提示 — 後端會組合它。
- 輪詢是靜默的。等待圖片網址準備就緒，然後交付。
模式
| 模式 | 當使用者想要… |
|---|---|
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, banner, 網站標題, 登陸頁面, 電子郵件標題, 寬格式 →
hero_banner - carousel, 投影片貼文, 多張投影片, 可滑動 →
social_carousel - 廣告, 廣告包, 付費社群, Meta / TikTok / Pinterest 廣告 →
ad_creative_pack - 模特兒穿著, 虛擬試穿, 在身體上, 時尚拍攝, lookbook →
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 / 3 / 5] - 什麼風格/情緒？
[乾淨攝影棚 / 生活風格 / 概念性 / 有模特兒 / 其他] - 您將在哪裡使用它們？
[Shopify / Instagram / Pinterest / 付費廣告 / 網站橫幅] - 需要搭配的品牌色？（如果明顯則跳過）
B 類型 — 上傳了產品照片，指定了使用案例
例如「為我的產品製作廣告」、「製作 Pinterest pin」、「製作 hero banner」。模式很明顯。只問遺漏的部分：
- 幾張？（如果是多輸出模式）
- 提供的內容 / 情緒 / 賣點是什麼？
- 有什麼需要特別強調的嗎？
C 類型 — 只有文字，沒有產品照片
- 可以上傳產品照片嗎？（推薦 — 品質高很多）
- 如果不行，請描述產品 — 類別、包裝、顏色、顯著特徵。
- 什麼風格？（同 A 類型的選項）
- 您將在哪裡使用它？
D 類型 — 上傳了現有圖片，要求「重做 / 改變氛圍 / 不同版本」
→ restyle
- 什麼美學？
[Clean girl / Cottagecore / Quiet luxury / Dark academia / Y2K / 其他] - 季節背景？
[聖誕節 / 情人節 / 萬聖節 / 黑色星期五 / 無] - 要保留什麼，要改變什麼？（僅在不明確時詢問）
E 類型 — 模特兒穿著產品（時尚、配件）
→ virtual_model_tryout
- 模特兒原型？（根據品牌受眾建議 2–3 個）
- 環境？
[乾淨攝影棚 / 戶外自然 / 街頭風格 / 編輯型錄 / 舒適家居] - 構圖？
[全身 / 四分之三 / 半身 / 產品區域特寫]
F 類型 — 模糊請求，主題不明確
例如「為我的品牌做些酷東西」。
- 什麼產品或主題？
- 目標？
[在市集銷售 / 建立品牌知名度 / 投放付費廣告 / 更新網站] - 可以上傳參考圖片嗎？
回答完後 → 返回相關的 A–E 類型。
生成
單一命令。後端組合最終提示並提交給 gpt_image_2。圖片網址輸出至 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 "陽光下的廚房流理台上的冷萃咖啡瓶，IG 貼文" \
--image bottle.jpg \
--count 3
higgsfield product-photoshoot create \
--mode moodboard_pin \
--prompt "我的蠟燭品牌的垂直 pin，cottagecore 風格" \
--image candle.jpg
higgsfield product-photoshoot create \
--mode restyle \
--prompt "聖誕節版本，quiet-luxury 美學" \
--image existing-shot.jpg
圖片輸入
--image 接受本地檔案路徑（自動上傳）或現有的上傳 UUID。如需多張參考圖片，請重複此參數。
多變體
--count 3 會回傳 3 個不同的圖片網址。後端會要求增強器在各變體之間變化佈光、角度和色板 — 它們不會是彼此的重述副本。
對於 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。
交付結果
以簡短的項目符號列表輸出圖片網址。不要輸出 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-generateMarketing Studio。 - 不取代用於無產品或品牌背景的原始文字轉圖片的
higgsfield-generate。
應避免的常見錯誤
- 在單一訊息中問超過 4 個問答問題。
- 選錯模式（例如使用者想要 Pinterest pin 時卻選了
product_shot）。 - 直接呼叫
higgsfield generate create gpt_image_2 --prompt ...而不是higgsfield product-photoshoot create— 這會繞過提示增強器，產生明顯較差的輸出。 - 將組合後的提示貼回給使用者 — 他們想要的是圖片網址。
- 使用上方表格中沒有的
--mode值。