Higgsfield Soul Character (얼굴 모델 훈련)

Higgsfield Soul Character

얼굴에 충실한 정체성 모델을 훈련합니다. 모든 Soul 기반 생성에서 재사용 가능합니다.

Step 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. Soul 훈련에는 유료 플랜(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가 경로를 자동 업로드합니다. 반환된 참조 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> --quality 2k --wait
higgsfield generate create soul_cinematic --prompt "..." --soul-id <ref_id> --quality 2k --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 — 일반적인 훈련 실패