O que Personagem Soul da Higgsfield faz?
Treine um modelo de identidade fiel ao rosto. Reutilizável em todas as gerações com tecnologia Soul.
Etapa 0 — Inicialização
Antes de qualquer outro comando:
- Se
higgsfieldnão estiver no$PATH, instale-o:curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh - Se
higgsfield account statusfalhar comSessão expirada/Não autenticado, peça ao usuário para executarhiggsfield auth login(interativo) e aguarde a confirmação. - O treinamento do Soul requer um plano pago (Basic+). Se
higgsfield account statusmostrar plano gratuito, avise o usuário antes de enviar.
Regras de UX
- Seja conciso. Nenhum ID bruto no chat. Apenas diga "Soul pronto" com uma referência de nome.
- Detecte o idioma e responda nele. As flags da CLI permanecem em inglês.
- Peça o menor conjunto de entradas: nome + fotos. Escolha uma variante de modelo sensata.
- A sondagem é silenciosa — o treinamento leva minutos. Não repita atualizações de status.
Fluxo de Trabalho
- Obter nome. Uma palavra, usada para referência posterior. Pergunte se estiver faltando.
- Obter fotos. 5–20 fotos de rosto, ângulos e iluminação variados. Caminhos locais ou IDs já enviados funcionam —
--imageaceita ambos. - Escolher variante.
--soul-2— para geração de imagem (padrão)--soul-cinematic— para trabalho cinematográfico / vídeo Escolha com base no uso final declarado pelo usuário. Padrão:--soul-2.
- Enviar.
A CLI faz upload automático de caminhos. Captura o id de referência retornado.higgsfield soul-id create --name "<nome>" --soul-2 --image ./foto1.png --image ./foto2.png ... higgsfield soul-id create --name "<nome>" --soul-2 --image <id_upload> --image <id_upload> ... - Aguardar.
higgsfield soul-id wait <id>. Silencioso. Tempo limite padrão: 30 min. - Entregar. "Soul
<nome>pronto. Use na geração com--soul-id <id>."
Usar o Soul
Após treinado, passe para 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
Listar Souls Existentes
higgsfield soul-id list # todas as referências
higgsfield soul-id get <id> # uma pelo id
Erros
Plano Basic mínimo necessário— o usuário está no plano gratuito; avise-o.Treinamento falhou— verifique a qualidade das fotos (5+ rostos únicos, bem iluminados).Sessão expirada→higgsfield auth login.
Documentação de referência
references/photo-guide.md— quais fotos funcionam melhorreferences/troubleshooting.md— falhas comuns de treinamento