Higgsfield Soul Character

步骤0 — 准备工作

1. 如果

   higgsfield

   不在

   $PATH

   中，请安装它：
   bash

   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. Soul训练需要付费套餐（基础版及以上）。如果

   higgsfield account status

   显示为免费套餐，请在提交前告知用户。

用户体验规则

1. 保持简洁。聊天中不要显示原始ID，只需告知“Soul已准备就绪”并附上名称标识。
2. 检测用户语言并使用对应语言回复。CLI参数保持英文。
3. 仅请求必要的最少输入：名称+照片。选择合适的模型变体。
4. 轮询过程静默进行——训练需要数分钟。不要重复发送状态更新。

工作流程

1. 获取名称：单个单词，用于后续标识。如果缺失请询问用户。
2. 获取照片：5-20张人脸照片，包含不同角度和光线条件。本地路径或已上传的ID均可——

   --image

   参数支持两种格式。
3. 选择模型变体：

   • --soul-2

     — 用于图像生成（默认选项）

   • --soul-cinematic

     — 用于电影级/视频制作 根据用户说明的后续用途选择，默认使用

     --soul-2

     。
4. 提交训练：
   bash

   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>

   已准备就绪。请在生成任务中使用

   --soul-id <id>

   参数。”

使用Soul模型

higgsfield-generate

higgsfield generate create text2image_soul_v2 --prompt "..." --soul-id <ref_id> --wait
higgsfield generate create soul_cinema_studio --prompt "..." --soul-id <ref_id> --wait

列出已有的Soul模型

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

  — 常见训练失败问题排查