Communitygithub.com

Personagem Soul da Higgsfield

Treine um Personagem Soul — um modelo personalizado no rosto de uma pessoa que a Higgsfield usa para geração de imagem e vídeo com fidelidade de identidade.

O que é Personagem Soul da Higgsfield?

Esta habilidade treina um modelo de identidade facial personalizado (Soul Character) usando a plataforma Higgsfield AI, que pode ser reutilizado para gerar imagens e vídeos que preservam a aparência de uma pessoa específica. O fluxo consiste em uma etapa única de treinamento que retorna um `reference_id`, o qual é então utilizado em comandos de geração posteriores (como `higgsfield-generate`) com modelos compatíveis como `text2image_soul_v2` ou `soul_cinema_studio`. Requer um plano pago (Basic+), aceita de 5 a 20 fotos com ângulos e iluminação variados, e oferece variantes: `--soul-2` para imagens e `--soul-cinematic` para vídeo. É ideal para criar um 'gêmeo digital' ou avatar realista para uso consistente em conteúdo visual, mas não é recomendado para trocas de rosto pontuais ou avatares não fotográficos.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/adamroy13/ai-influencer-promo-machine/tree/HEAD/.agents/skills/higgsfield-soul-id

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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:

  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 Sessão expirada / Não autenticado, peça ao usuário para executar higgsfield auth login (interativo) e aguarde a confirmação.
  3. O treinamento do Soul requer um plano pago (Basic+). Se higgsfield account status mostrar plano gratuito, avise o usuário antes de enviar.

Regras de UX

  1. Seja conciso. Nenhum ID bruto no chat. Apenas diga "Soul pronto" com uma referência de nome.
  2. Detecte o idioma e responda nele. As flags da CLI permanecem em inglês.
  3. Peça o menor conjunto de entradas: nome + fotos. Escolha uma variante de modelo sensata.
  4. A sondagem é silenciosa — o treinamento leva minutos. Não repita atualizações de status.

Fluxo de Trabalho

  1. Obter nome. Uma palavra, usada para referência posterior. Pergunte se estiver faltando.
  2. Obter fotos. 5–20 fotos de rosto, â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 trabalho cinematográfico / vídeo Escolha com base no uso final 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 <id_upload> --image <id_upload> ...
    
    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: 30 min.
  6. 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 melhor
  • references/troubleshooting.md — falhas comuns de treinamento

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

adamroy13/ai-influencer-promo-machine

A 5-stage AI content pipeline using Higgsfield MCP, focused on viral UGC content split evenly across 5 formats: UGC Entertainment (challenges), Street Interview, Unboxing, Product Review, ASMR. Button-driven UX — clicks, no typed commands. Stage 1: probe Marketing Studio capability, research trends in the product's niche on Instagram, TikTok, YouTube, and turn them into prompts mapped to the 5 formats with picklist hooks. Stage 2: produce one HTML video content plan; user sets the count, the skill divides evenly across the 5 formats. Stage 3: generate videos one format batch at a time, then auto-generate the image asset pack via GPT Image 2.0. Stage 4: schedule to Meta Ads via Meta MCP. Stage 5: render a cost comparison — Higgsfield credits + USD spent vs traditional production cost. Trigger on a product image + content request, or phrases like 'create a campaign', 'build a content plan', 'make videos in Higgsfield', 'generate the image pack', 'schedule to Meta', 'run the content pipeline'.

adamroy13/ai-influencer-promo-machine

Generate images/videos via Higgsfield AI. Default: GPT Image 2 for images/design/text, Seedance 2.0 for video, Nano Banana 2/Pro for character/reference image work, Marketing Studio for ads with avatars/products/hooks, settings, plus Soul V2/Cinema/Cast/Location and Kling 3.0. Use when: "generate an image", "make a video", "animate this photo", "image-to-video", "edit/stylize/remix this image", "produce a clip", "create an ad", "make a UGC video", "product demo", "unboxing", "brand video", "presenter video", "import product from URL", "create avatar for ad", or "analyze video virality". Supports image-to-image, image-to-video, references, job/upload IDs, and Marketing Studio. Chain with higgsfield-soul-id for face/identity consistency. Virality Predictor (`brain_activity`) analyzes video virality: hook strength, attention, retention, distraction risk, and creative score. NOT for: Soul Character training (use higgsfield-soul-id), product photoshoots, marketplace listing cards, text/chat/TTS tasks.

adamroy13/ai-influencer-promo-machine

Generate marketplace product image cards through Higgsfield: compliant main image, secondary product images, and A+ style content modules. Use when the user asks for marketplace listing images, product detail cards, secondary product images, product infographics, lifestyle listing shots, A+ style content, marketplace image sets, or sales-ready product visuals. Backend owns marketplace compliance references and prompt templates; this skill only routes user intent to the CLI. NOT for generic brand product photography without marketplace/listing context (use higgsfield-product-photoshoot), video generation or UGC ads (use higgsfield-generate), or Soul Character training (use higgsfield-soul-id).

adamroy13/ai-influencer-promo-machine

Generate brand-quality product images through Higgsfield product-photoshoot prompt enhancement on GPT Image 2 / gpt_image_2. Entry point for professional brand/product visuals. Use when: "product photo", "studio shot", "lifestyle image", "Pinterest pin", "hero/banner", "carousel", "ad creative", "Meta ads", "virtual try-on", "model wearing", "person holding product", "closeup with hands", "levitating/floating/splash product", "CGI/surreal product", "restyle", "seasonal/aesthetic variation", or any product, brand, or paid-social creative. Modes: product_shot, lifestyle_scene, closeup_product_with_person, moodboard_pin, hero_banner, social_carousel, ad_creative_pack, virtual_model_tryout, conceptual_product, restyle. Backend assembles the final prompt; never freehand it. NOT for: no-product text-to-image (use higgsfield-generate), branded avatar video (use higgsfield-generate Marketing Studio), marketplace listing cards (use higgsfield-marketplace-cards), Soul Character training (use higgsfield-soul-id).

Habilidades Relacionadas