Higgsfield 靈魂角色訓練

Higgsfield Soul Character（靈魂角色）

訓練一個忠於臉部特徵的身份模型。可重複用於所有支援 Soul 功能的生成任務。

步驟 0 — 初始化

在執行任何其他指令之前：

1. 如果 higgsfield 不在 $PATH 中，請安裝它：

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

2. 若 higgsfield account status 出現 Session expired / Not authenticated 錯誤，請要求用戶執行 higgsfield auth login（互動式）並等待確認。
3. 靈魂角色訓練需要付費方案（Basic 以上）。如果 higgsfield account status 顯示為免費方案，請在提交前告知用戶。

UX 規則

1. 簡潔扼要。聊天中不要顯示原始 ID。只需說「Soul 已就緒」並附上名稱參考。
2. 偵測語言並以該語言回覆。CLI 標誌維持英文。
3. 只要求最少量的輸入：名稱 + 照片。選擇合理的模型變體。
4. 輪詢過程保持靜默 — 訓練需要幾分鐘。不要重複更新狀態。

工作流程

1. 取得名稱。 一個詞，用於後續參考。如果缺少則詢問。
2. 取得照片。 5 到 20 張臉部照片，需有不同角度和光線。本機路徑或已上傳的 ID 均可使用 — --image 接受兩者。
3. 選擇變體。
   • --soul-2 — 用於圖像生成（預設）
   • --soul-cinematic — 用於影片 / 電影級生成 根據用戶說明的下游用途來選擇。預設為 --soul-2。
4. 提交。

   higgsfield soul-id create --name "<name>" --soul-2 --image ./photo1.png --image ./photo2.png ...
   higgsfield soul-id create --name "<name>" --soul-2 --image <upload_id> --image <upload_id> ...
   

   CLI 會自動上傳路徑。抓取返回的 reference id。
5. 等待。 higgsfield soul-id wait <id>。靜默執行。預設超時 30 分鐘。
6. 交付。「Soul <name> 已就緒。在 generate 中使用 --soul-id <id>。」

使用 Soul

訓練完成後，將其傳遞給 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

列出現有的 Souls

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 — 常見訓練失敗問題