VideoMakerStudio - Higgsfield AI 影像生成工具

Higgsfield Generate

將任務提交到任何 Higgsfield 模型。包裝了 higgsfield CLI。涵蓋通用的圖片/影片生成、Marketing Studio（品牌廣告、頭像、產品、鉤子、場景設定），以及次要的病毒式傳播預測器（Virality Predictor）影片評分。

步驟 0 — 初始化

在任何其他命令之前：

1. 如果系統路徑中沒有 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. 簡潔扼要。不要在對話中顯示原始 ID 或 JSON 資料。對於生成的資產，列印媒體 URL；對於病毒式傳播預測器，則列印文字摘要。
2. 避免內部術語。不要說明「正在呼叫 higgsfield cost」或「正在輪詢任務」。
3. 從第一則訊息中偵測使用者的語言並以其回覆。技術引數（--aspect_ratio 16:9）保持英文。
4. 不要一次問太多問題。先選擇一個合理的預設模型，只有在確實缺少資訊時才一次問一個問題。
5. 除非使用者要求，否則不要預先估算成本或為了更便宜的模型而最佳化。首先偏好品質預設值。
6. 將 --wait 傳遞給 generate create，讓命令阻塞直到完成並自動列印結果 URL。避免使用 create → wait 的兩步驟模式。

探索護欄

在尋找 Higgsfield 功能/模型時，不要僅依賴語義搜尋或 CLI 的 --help。首先執行未過濾的模型列表，然後檢查可能的 job_set_type 名稱。如果使用者說某個模型存在但搜尋沒有結果，請信任該訊號並在回答前使用完整模型列表進行驗證。

病毒式傳播預測器（Virality Predictor）的公開方式如下：

• 客戶面向名稱：病毒式傳播預測器
• 技術 job_set_type：brain_activity
• 類別/輸出：文字報告。這是影片輸入/文字輸出的分析，不是文字/聊天生成模型。
• 輸入：上傳的影片
• 目的：完成影片的鉤子、注意力、留存率和病毒式傳播分析

如果使用者說「分析這部影片」、「為這個廣告評分」、「評估這個鉤子」或類似內容，即使它出現在文字/分析模型下，也要路由到 brain_activity。根據任務意圖和所需的輸入進行分類，而不僅僅是輸出類別。

工作流程 — 通用生成

1. 選擇模型。 除非需求明確需要特定模型，否則從核心預設值開始：

   • GPT Image 2 → 高保真通用生成、圖形設計、UI、橫幅、印刷體以及圖上文字的預設圖片模型。
   • Seedance 2.0 → 嚴肅的動作、電影級短片、多鏡頭工作、圖片轉影片以及 4-15 秒的品質輸出的預設影片模型。12 秒是有效的。
   • Nano Banana 2/Pro → 角色、卡通、風格化和參考驅動的圖片工作的預設模型；對於更難的需求，請使用 Pro 版本。
   • Marketing Studio → 廣告、UGC、產品展示、開箱、電視廣告、演講者影片以及品牌/產品工作流程的預設模型。

   圖片：

   • 品牌產品視覺（Pinterest Pin、生活風格、英雄橫幅、廣告包、虛擬試穿）→ 改用 higgsfield-product-photoshoot。不屬於此技能。
   • 生成的產品概念/包裝/罐裝/瓶裝，帶有品牌名稱或標籤文字 → GPT Image 2。
   • 帶有頭像 + 產品的品牌廣告圖片（Marketing Studio 格式）→ Marketing Studio Image（參見下方的 Marketing Studio）
   • 美學 UGC / 時尚編輯 / 生活風格角色 → Soul 2.0
   • 電影級靜態畫面 → Soul Cinema
   • 高度角色化的創意人物（純文字，特色鮮明）→ Soul Cast
   • 地點 / 環境 / 無人物場景 → Soul Location（同類最佳）
   • 向量插圖 或 臉部編輯 + 複雜場景替換 → Seedream 4.5
   • Soul Character（來自 higgsfield-soul-id 的參考身份）→ 靜態圖片用 Soul 2.0，電影級用 Soul Cinema
   • 角色或卡通風格工作 → Nano Banana 2；困難情況升級到 Nano Banana Pro
   • 快速且便宜的迭代 → Z Image
   • 其他所有情況的預設值 → GPT Image 2。 圖形設計、UI、橫幅、印刷體和高保真通用生成。

   影片：

   • 所有廣告 / 商業 / 品牌廣告影片 → Marketing Studio（參見下方的 Marketing Studio）
   • 所有用途的預設嚴肅影片（多鏡頭、一致的身份、動作豐富、圖片轉影片、4-15 秒請求）→ Seedance 2.0。 最新技術。不要僅僅因為 Seedance 1.5 的時長列舉更容易讀取就降級到它；首先驗證 Seedance 2.0。
   • 單一平面場景，沒有強烈動態，比 Seedance 2.0 便宜 → Kling 3.0
   • 便宜的乾淨鏡頭，沒有剪輯，僅在使用者要求更便宜/預算輸出時 → Seedance 1.5 Pro
   • 電影級最高保真度 → Cinema Studio Video 3.0
   • 便宜且物理效果強，不需要音訊 → Minimax Hailuo
   • 快速批次 / 大量 → Veo 3.1 Lite

   影片分析：

   • 評估已完成影片的鉤子、病毒式傳播潛力、注意力、留存率或分心風險 → 病毒式傳播預測器（brain_activity）。這是一個回傳文字評分/報告的影片分析模型，而不是生成的媒體資產。

   對於要傳遞給 higgsfield generate create 的實際 --model ID，執行 higgsfield model list --json | jq 以將顯示名稱對應到 ID。請參閱 references/model-catalog.md 以取得完整表格。

2. 將媒體輸入直接傳遞給旗標。 媒體旗標接受本地檔案路徑 或 UUID。CLI 會自動上傳路徑，並自動偵測任務與上傳之間的 UUID。無需預先上傳。每個模型都宣告了接受的類型（image、start_image、end_image、video、audio）——請參閱 references/media-inputs.md。

3. 快速驗證。 如果不確定參數，執行 higgsfield model get <jst> --json 一次，並僅傳遞所需的參數。在降級到較舊模型之前，請先驗證首選模型。否則使用 schema 預設值。伺服器會為非致命的強制轉換（例如 aspect_ratio=99:99 → 最接近的匹配）回傳 adjustments，並為無效的宣告參數值回傳結構化錯誤。

4. 一鍵提交並等待。 higgsfield generate create <jst> [--prompt "..."] [media flags] [param flags] --wait。阻塞直到達到終端狀態，並將結果列印到 stdout。可調整項：--wait-timeout 20m（預設 10m）、--wait-interval 5s（預設 3s）。病毒式傳播預測器不需要提示詞；傳遞 --video。

5. 交付結果。 對於生成的媒體，傳送 URL 以及一行摘要（模型、如果是影片則加上時長）。對於病毒式傳播預測器，交付分數、業務解釋和 Open 報告連結。不要在正常的對話輸出中顯示 .glb、.bin 或區域表內部細節。

若要稍後檢查或重新執行，higgsfield generate list --json 和 higgsfield generate get <id> --json 可用於回顧。higgsfield generate wait <id> 仍然可用，如果您需要重新加入未使用 --wait 啟動的任務。

媒體旗標

旗標	用途	接受的模型
--image <path-or-id>	參考圖片	大多數圖片模型、seedance_2_0、veo3、marketing_studio_video
--start-image <path-or-id>	圖片轉影片過渡的首幀	kling3_0、kling2_6、veo3_1、seedance_2_0、marketing_studio_video
--end-image <path-or-id>	過渡的最後一幀	kling3_0、seedance_2_0、marketing_studio_video
--video <path-or-id>	參考或分析的影片	seedance_2_0、brain_activity
--audio <path-or-id>	參考音訊（唇形同步、配樂匹配）	seedance_2_0（使用此項，不要使用 --generate-audio）

每個旗標都接受本地檔案路徑（自動上傳）或 UUID（來自 higgsfield upload create 的上傳 ID，或先前的任務 ID）。每個模型透過 MEDIA_ROLES 宣告自己的角色集。請參閱 references/media-inputs.md 以取得完整表格。

常用參數

旗標會傳遞到模型 schema。使用 higgsfield model get <jst> 來發現。

higgsfield generate create gpt_image_2 --prompt "neon city at dusk" --aspect_ratio 16:9 --resolution 2k --wait
higgsfield generate create nano_banana_2 --prompt "anime character concept, expressive pose" --image ./ref.png --wait
higgsfield generate create seedance_2_0 --prompt "camera dollies in" --start-image ./first.png --duration 12 --wait
higgsfield generate create text2image_soul_v2 --prompt "..." --soul-id <soul_ref_id> --quality 2k --wait
higgsfield generate create brain_activity --video ./ad.mp4 --wait

若要取得機器可讀的輸出（鏈式管道、代理上下文），請加上 --json。使用 --wait --json 時，您會得到最終任務物件陣列。不使用 --wait 時，您會得到任務 ID。病毒式傳播預測器將原始分析和渲染工件儲存在任務參數中，但預設文字輸出應保留分數加上 Open 報告。

從 stdin 輸入提示詞：echo "..." | higgsfield generate create z_image --wait。

Soul 圖片品質：對於 text2image_soul_v2 和 soul_cinematic，傳遞 --quality 1.5k 或 --quality 2k。這些是 UI 面向的層級；後端會將其對應到 720p/1080p，並根據所選的 --aspect_ratio 對應到模型特定的尺寸。soul_location 沒有品質選擇器；它對每個長寬比使用固定的尺寸。

Marketing Studio

品牌圖片/影片生成：頭像 + 產品 + 可選的設定鉤子/場景 + 廣告風格模式。使用 marketing_studio_video 和 marketing_studio_image 模型。

概念

• 頭像 (Avatar) — 演講者的臉。可以是策展的 preset（瀏覽 higgsfield marketing-studio avatars list）或 custom（透過 higgsfield marketing-studio avatars create 上傳照片）。對於 UGC 模式，如果需求中明確提到某個人，頭像是可選的；後端可以自動建立一個 Soul Character。當使用者想要一個特定的演講者時，請傳遞頭像。
• 產品 (Product) — 帶有標題和參考圖片的品牌商品。可以從 URL 匯入（higgsfield marketing-studio products fetch --url ...）或從上傳的圖片建立（higgsfield marketing-studio products create）。
• 網路產品 (Webproduct) — App Store / 網頁版本。在獲取 App Store URL 時自動路由。
• 鉤子 (Hook) — 可重複使用的開場角度 / 廣告鉤子。使用 higgsfield marketing-studio hooks list 瀏覽。鉤子文字會前置到使用者的提示詞中；它不會取代 --prompt。
• 場景設定 (Setting) — 可重複使用的環境 / 場景上下文。使用 higgsfield marketing-studio settings list 瀏覽。
• 廣告參考 (Ad reference) — 可重複使用的靈感影片，可以綁定到頭像和/或產品。從上傳的影片（--video-input <upload_id>）或先前的生成任務（--job <job_id>）建立。使用 higgsfield marketing-studio ad-references list 瀏覽。請參閱 references/marketing-ad-references.md。
• 品牌套件 (Brand kit) — 擷取品牌的身份（名稱、標誌、英雄圖片、顏色、字體、語調）以便在圖片生成中重複使用。透過提供網站 URL 來建立（higgsfield marketing-studio brand-kits fetch --url https://… --wait）。請參閱 references/marketing-brand-kits.md。
• 廣告格式 (Ad format) — 驅動生成圖片視覺結構的預設集（headline、bullet-points 等）。唯讀，使用 higgsfield marketing-studio ad-formats list 瀏覽。dtc-ads generate 的必填輸入。

探索命令

當使用者詢問已存在的內容時，請使用這些確切的列表命令：

higgsfield marketing-studio avatars list --json
higgsfield marketing-studio products list --json
higgsfield marketing-studio hooks list --json
higgsfield marketing-studio settings list --json
higgsfield marketing-studio ad-references list --json
higgsfield marketing-studio brand-kits list --json
higgsfield marketing-studio ad-formats list --json

--hook_id 和 --setting_id 僅被 marketing_studio_video 支援；不要將它們傳遞給 marketing_studio_image。

使用者體驗規則（補充）

• 每個階段只問一個問題。不要一次問產品+頭像+模式。
• 兩種廣告方式是互斥的。 使用者要嘛提供廣告參考影片（參考驅動），要嘛挑選鉤子/場景區塊（從區塊組合）——不能同時使用。如果使用者已選取廣告參考，請不要提供鉤子/場景；如果已選取鉤子/場景，請不要提供附加廣告參考。
• 廣告參考來源。 唯一有效的輸入是本地影片檔案（透過 higgsfield upload create ... --video 上傳）或先前的影片任務。如果使用者提供其他內容，請要求提供本地檔案。
• dtc-ads 廣告格式是必填的。 始終請使用者從 ad-formats list 中挑選。沒有自動預設值——CLI 和伺服器都會拒絕沒有 --format-id 的呼叫。
• dtc-ads 可選輸入。 當需求需要時，建議使用頭像、產品和參考媒體；只附加使用者選擇的內容。

工作流程 — 快速廣告影片

1. 獲取產品。
   • 現有產品 → higgsfield marketing-studio products list --json
   • URL → higgsfield marketing-studio products fetch --url <url> --wait（輪詢直到匯入完成）
   • 本地圖片 → higgsfield upload create <photo>... 然後 higgsfield marketing-studio products create --title "..." --image <id>... 擷取產品 ID。使用 --hook_id 時，強烈建議傳遞 --product_ids；鉤子的設計是為了引入產品，沒有產品上下文的表現會很差。
2. 如有必要，挑選頭像。
   • 預設：higgsfield marketing-studio avatars list 並挑選符合品牌聲音的策展人預設頭像。
   • 自訂：higgsfield marketing-studio avatars create --name "..." --image <upload_id>。 對於 UGC 模式，當不需要特定演講者且需求中提到某人時，您可以省略 --avatars；後端可以合成一個 Soul Character。
3. 可選地挑選設定項目。
   • 鉤子：higgsfield marketing-studio hooks list --json
   • 場景設定：higgsfield marketing-studio settings list --json 將選定的 ID 作為 --hook_id <hook_id> 和 --setting_id <setting_id> 傳遞給 marketing_studio_video。除非使用者明確想要強化相同的措辭，否則不要將鉤子的提示詞複製到 --prompt。
4. 如有必要，挑選模式。 預設為 ugc；僅僅因為存在 --hook_id，--mode 就不是必需的。其他模式包括 dtc-ads（醜聞驅動/品牌形象廣告）、headshot（專業頭像）、product（僅限產品）、vlog、review、tutorial 和 story。如果使用者說「為我創建一個 DTC 廣告影片」，則預設值改為 dtc-ads。
5. 一鍵生成。

higgsfield generate create marketing_studio_video \
  --product_ids <product_id> \
  --avatars <avatar_id> \
  --hook_id <hook_id> \
  --setting_id <setting_id> \
  --prompt "..." \
  --wait

如果在請求時尚未選擇，請跳過可選的鉤子和場景設定。不要預選它們。

對於 dtc-ads 模式：

higgsfield generate create marketing_studio_video \
  --mode dtc-ads \
  --format-id <format_id> \
  --product_ids <product_id> \
  --avatars <avatar_id> \
  --ad-reference-id <ref_id> \
  --prompt "..." \
  --wait

工作流程 — 快速廣告圖片

使用 marketing_studio_image，它不接受 --hook_id、--setting_id、--start-image 或 --end-image。

higgsfield generate create marketing_studio_image \
  --product_ids <product_id> \
  --avatars <avatar_id> \
  --prompt "..." \
  --wait

病毒式傳播預測器

分析已完成影片的病毒式傳播潛力。需要 --video 且不需要 --prompt。

輸出：回傳一個文字報告，包含鉤子強度、注意力、留存率、分心風險、創意分數和維度（按性別/年齡/平台）。交付分數、業務解釋和 Open 報告連結。

higgsfield generate create brain_activity --video ./ad.mp4 --wait

處置與後續行動

ID 是穩定的，可供未來工作重複使用。任何生成的媒體都可以用作後續任務的輸入。

內部參考

• references/model-catalog.md — 模型 ID 對應
• references/media-inputs.md — 媒體輸入角色
• references/marketing-ad-references.md — 使用廣告參考影片
• references/marketing-brand-kits.md — 品牌套件配置
• references/marketing-avatars.md — 頭像建立指南
• references/marketing-products.md — 產品建立指南
• references/marketing-hooks.md — 鉤子建立指南
• references/chronos.md — 時間軸 / 動畫參數
• references/prompting-strategies.md — 提示詞撰寫策略