商品攝影

透過 higgsfield product-photoshoot create 命令生成品牌影像。此 CLI 會呼叫一個後端提示增強器，該增強器內含特定模式的攝影詞彙與結構化模板，然後將結果提交給 gpt_image_2，最後回傳影像 URL。

步驟 0 — 初始化

在任何其他命令之前：

如果系統路徑中沒有 higgsfield，請安裝它：

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

如果 higgsfield account status 回傳 Session expired / Not authenticated，請要求使用者執行 higgsfield auth login（互動式）並等待確認。

使用者體驗規則

回應要簡潔。最終回覆只輸出影像 URL。
偵測語言並以該語言回應。模式名稱和 CLI 標誌保持英文。
在提交前最多問 4 個簡短問題。使用有標籤的選項，絕不開放式提問。
跳過那些從上下文（已上傳的影像、先前的對話、品牌記憶）就能明顯看出答案的問題。
絕對不要自己編寫 gpt_image_2 的提示——由後端負責組裝。
輪詢是靜默的。等到 URL 就緒後再交付。

模式

模式	當使用者想要…
`product_shot`	商品在純色 / 攝影棚 / 目錄背景上
`lifestyle_scene`	商品在真實環境中，有手部動作、情境氛圍
`closeup_product_with_person`	極特寫，帶有手部 / 部分臉部 — 美容應用、手持、展示
`moodboard_pin`	垂直 2:3 比例的 Pinterest 原生美學、情緒板風格
`hero_banner`	寬幅格式的網站 / 電子郵件 / 行銷活動橫幅
`social_carousel`	用於 IG / LinkedIn / Facebook 的 3–10 張連續幻燈片
`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, vertical pin → moodboard_pin
hero, banner, 網站橫幅, 登陸頁面, 電子郵件標頭, 寬幅 → hero_banner
carousel, 滑動貼文, 多張滑動, 可滑動 → social_carousel
ads, 廣告包, 付費社群, Meta / TikTok / Pinterest 廣告 → ad_creative_pack
模特兒穿著, 虛擬試穿, 穿在身上的, 時尚拍攝, lookbook → virtual_model_tryout
漂浮, 懸浮, 潑濺, 凍結動作, 超現實, CGI, 雕塑感 → conceptual_product
修改 EXISTING 影像的美學、氛圍、季節——不改變主體 → restyle

平手時如何決定：

"我的產品在廚房流理台上的 Pinterest 圖釘" → moodboard_pin（Pinterest 是平台）
"展示我產品使用情境的英雄橫幅" → hero_banner（橫幅格式優先）
"我的產品在不同場景中的輪播廣告" → social_carousel（多張幻燈片優先）
"正在塗抹我精華液的人的特寫" → closeup_product_with_person（特定類型優先）

生成前訪談

在提交前問 3–4 個簡短問題。總是提供有標籤的選項，絕不開放式提問。跳過那些從上下文就能明顯看出答案的問題。

類型 A — 上傳了商品照片，"為我製作圖片/攝影作品"

需要幾張？[1 / 3 / 5]
什麼風格/氛圍？[乾淨攝影棚 / 生活情境 / 概念化 / 搭配模特兒 / 其他]
你會用在何處？[Shopify / Instagram / Pinterest / 付費廣告 / 網站主視覺]
需要搭配的品牌顏色？（如果顯而易見則跳過）

類型 B — 上傳了商品照片，說明了使用情境

例如 "為我的產品製作廣告"、"製作 Pinterest 圖釘"、"製作英雄橫幅"。模式很明顯。只問不足之處：

需要幾張？（如果是多輸出模式）
提供的優惠 / 氛圍 / 賣點是什麼？
有沒有特別需要強調的地方？

類型 C — 只有文字，沒有商品照片

可以上傳一張商品照片嗎？（偏好——品質會高很多）
如果不行的話，請描述商品——類別、包裝、顏色、顯著特徵。
想要什麼風格？（選項同類型 A）
你會用在何處？

類型 D — 上傳了現有影像，"重做 / 改變風格 / 換個版本"

→ restyle

想要什麼美學風格？[Clean girl / Cottagecore / Quiet luxury / Dark academia / Y2K / 其他]
季節背景？[聖誕節 / 情人節 / 萬聖節 / 黑色星期五 / 無]
要保留什麼，改變什麼？（僅在不明確時問）

類型 E — 模特兒穿著產品（時尚、配件）

→ virtual_model_tryout

模特兒類型？（根據品牌受眾建議 2–3 種）
環境？[攝影棚乾淨 / 戶外自然 / 街頭風格 / 時尚編輯 / 居家舒適]
構圖？[全身 / 四分之三 / 腰部以上 / 產品部位特寫]

類型 F — 模糊請求，主體不明

例如 "為我的品牌做些酷東西"。

是什麼產品或主題？
目標？[在平台銷售 / 建立品牌知名度 / 投放付費廣告 / 更新網站]
可以上傳參考圖片嗎？

獲得答案後 → 回到相關的類型 A–E。

生成

單一命令。後端會組裝最終提示並提交給 gpt_image_2。URL 會印在標準輸出。

higgsfield product-photoshoot create \
  --mode <模式> \
  --prompt "<從訪談答案中提取的簡短使用者意圖描述>" \
  [--image <路徑或上傳ID>]... \
  [--count <1-10>] \
  [--aspect_ratio <覆寫>]

範例：

higgsfield product-photoshoot create \
  --mode lifestyle_scene \
  --prompt "一瓶冷萃咖啡在陽光灑落的廚房流理臺上，IG 動態" \
  --image bottle.jpg \
  --count 3

higgsfield product-photoshoot create \
  --mode moodboard_pin \
  --prompt "為我的香氛蠟燭品牌製作的垂直圖釘，田園舒適風格" \
  --image candle.jpg

higgsfield product-photoshoot create \
  --mode restyle \
  --prompt "聖誕節版本，低調奢華美學" \
  --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。

解析度

每次 product-photoshoot 任務都使用 2k。

交付結果

以簡短的項目符號列表印出影像 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 圖釘時卻選了 product_shot）。
直接呼叫 higgsfield generate create gpt_image_2 --prompt ... 而非 higgsfield product-photoshoot create——這會繞過提示增強器，導致輸出品質明顯變差。
將組裝好的提示貼給使用者——他們想要的是 URL。
使用上方表格中沒有的 --mode 值。

商品攝影工作室 (Product Photoshoot)