Higgsfield 靈魂角色
訓練一個忠於臉部特徵的身分模型。可在所有靈魂驅動的生成中重複使用。
步驟 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（互動式）並等待確認。 - 靈魂訓練需要付費方案（Basic+）。如果
higgsfield account status顯示為免費方案，請在送出前告知使用者。
UX 規則
- 簡潔為上。聊天中不要顯示原始 ID。只需說「靈魂已就緒」並附上名稱參考。
- 偵測語言並以該語言回應。CLI 標誌保持英文。
- 要求最小輸入：名稱 + 照片。選擇一個合理的模型變體。
- 輪詢是靜默的——訓練需要幾分鐘。不要重複更新狀態。
工作流程
- 取得名稱。 一個字詞，用於後續參考。如果遺漏請詢問。
- 取得照片。 5–20 張臉部照片，不同角度和光線。本機路徑或已上傳的 ID 均可——
--image接受兩者。 - 選擇變體。
--soul-2— 用於圖片生成（預設）--soul-cinematic— 用於電影級/影片工作 根據使用者指定的下游用途選擇。預設為--soul-2。
- 提交。
higgsfield soul-id create --name "<名稱>" --soul-2 --image ./photo1.png --image ./photo2.png ... higgsfield soul-id create --name "<名稱>" --soul-2 --image <上傳ID> --image <上傳ID> ... - 等待。
higgsfield soul-id wait <id>。靜默執行。預設逾時 30 分鐘。 - 傳遞結果。「靈魂
<名稱>已就緒。在 generate 中使用--soul-id <id>。」
使用靈魂
訓練完成後，傳遞給 higgsfield-generate：
higgsfield generate create text2image_soul_v2 --prompt "..." --soul-id <ref_id> --quality 2k --wait
higgsfield generate create soul_cinematic --prompt "..." --soul-id <ref_id> --quality 2k --wait
列出現有靈魂
higgsfield soul-id list # 所有參考
higgsfield soul-id get <id> # 依 ID 查詢一個
錯誤處理
Minimum Basic plan required— 使用者是免費方案；告知他們。Training failed— 檢查照片品質（5 張以上不同的清晰臉部，光線充足）。Session expired→higgsfield auth login。
參考文件
references/photo-guide.md— 哪些照片效果最好references/troubleshooting.md— 常見訓練失敗原因