Higgsfield 소울 캐릭터
얼굴을 충실하게 재현하는 신원 모델을 학습합니다. 모든 소울 기반 생성에서 재사용 가능합니다.
0단계 — 초기 설정
다른 명령을 실행하기 전에:
higgsfield가$PATH에 없으면 설치합니다:curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | shhiggsfield 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 "<name>" --soul-2 --image ./photo1.png --image ./photo2.png ... higgsfield soul-id create --name "<name>" --soul-2 --image <upload_id> --image <upload_id> ... - 대기.
higgsfield soul-id wait <id>자동 처리. 기본 제한 시간 30분. - 전달. "소울
<name>준비됨. 생성 시--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— 일반적인 학습 실패