Higgsfield Soul Character

O que Higgsfield Soul Character faz?

Treine um modelo de identidade fiel ao rosto. Reutilizável em todas as gerações com suporte a Soul.

Etapa 0 — Inicialização

Antes de qualquer outro comando:

1. Se higgsfield não estiver no $PATH, instale-o:

   curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
   

2. Se higgsfield account status falhar com Session expired / Not authenticated, peça ao usuário para executar higgsfield auth login (interativo) e aguarde a confirmação.
3. O treinamento de Soul requer um plano pago (Basic+). Se higgsfield account status mostrar plano gratuito, informe o usuário antes de prosseguir.

Regras de UX

1. Seja conciso. Não exiba IDs brutos no chat. Apenas diga "Soul pronto" com uma referência de nome.
2. Detecte o idioma e responda nele. Flags da CLI permanecem em inglês.
3. Solicite o menor conjunto de entradas: nome + fotos. Escolha uma variante de modelo adequada.
4. A consulta de status é silenciosa — o treinamento leva minutos. Não repita atualizações de status.

Fluxo de Trabalho

1. Obter nome. Uma palavra, usada como referência posterior. Pergunte se estiver faltando.
2. Obter fotos. 5 a 20 fotos do rosto, com ângulos e iluminação variados. Caminhos locais ou IDs já enviados funcionam — --image aceita ambos.
3. Escolher variante.
   • --soul-2 — para geração de imagem (padrão)
   • --soul-cinematic — para trabalhos cinematográficos / vídeo Escolha com base no uso subsequente declarado pelo usuário. Padrão: --soul-2.
4. Enviar.

   higgsfield soul-id create --name "<nome>" --soul-2 --image ./foto1.png --image ./foto2.png ...
   higgsfield soul-id create --name "<nome>" --soul-2 --image <upload_id> --image <upload_id> ...
   

   A CLI faz upload automático de caminhos. Captura o ID de referência retornado.
5. Aguardar. higgsfield soul-id wait <id>. Silencioso. Tempo limite padrão de 30 minutos.
6. Entregar. "Soul <nome> pronto. Use em 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 por ID

Erros

• Minimum Basic plan required — o usuário está no plano gratuito; informe-o.
• Training failed — verifique a qualidade das fotos (5+ rostos únicos, bem iluminados).
• Session expired → higgsfield auth login.

Documentação de referência

• references/photo-guide.md — quais fotos funcionam melhor
• references/troubleshooting.md — falhas comuns de treinamento