Higgsfield 灵魂角色训练

Higgsfield 灵魂角色训练 是做什么的？

训练一个面部身份忠实模型。可在所有支持灵魂角色的生成任务中重复使用。

第零步 —— 初始化

在执行任何其他命令前：

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 显示为免费计划，请在提交前告知用户。

用户体验规则

1. 保持简洁。不要在聊天中显示原始 ID。只需说“灵魂角色就绪”并引用名称。
2. 检测用户语言并以此语言回复。CLI 参数保持英文。
3. 只询问最少的信息：名称 + 照片。选择一个合理的模型变体。
4. 静默轮询——训练需要几分钟。不要重复更新状态。

工作流程

1. 获取名称。 一个单词，用于后续引用。如果缺失则询问。
2. 获取照片。 5–20 张面部照片，需包含不同角度和光照条件。本地路径或已上传的 ID 均可 —— --image 参数接受两者。
3. 选择模型变体。
   • --soul-2 —— 用于图像生成（默认）
   • --soul-cinematic —— 用于电影/视频工作 根据用户声明的下游用途选择。默认使用 --soul-2。
4. 提交任务。

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

   CLI 会自动上传本地路径。捕获返回的参考 ID。
5. 等待。 执行 higgsfield soul-id wait <id>。静默模式。默认超时 30 分钟。
6. 交付。 “灵魂角色 <名称> 就绪。在生成时使用 --soul-id <id>。”

使用灵魂角色

训练完成后，将参数传递给 higgsfield-generate：

higgsfield generate create text2image_soul_v2 --prompt "..." --soul-id <引用ID> --quality 2k --wait
higgsfield generate create soul_cinematic --prompt "..." --soul-id <引用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 —— 常见训练失败原因