Communitygithub.com

Personnage AI

Créez un modèle personnalisé d'un visage pour générer des images et vidéos fidèles à l'identité via Higgsfield.

Qu'est-ce que Personnage AI ?

Cette compétence permet de créer un **Personnage IA** (Soul Character) avec Higgsfield AI : un modèle personnalisé entraîné sur des photos d'une personne, réutilisable pour générer des images et vidéos où cette personne apparaît avec une fidélité identitaire élevée. Elle est utile pour tout scénario nécessitant une représentation cohérente du même visage dans des contenus générés, comme des 'jumeaux numériques', des avatars personnalisés ou des personnages de vidéo. La compétence est compatible avec les outils CLI `higgsfield` et `higgsfield-generate`, et fonctionne sur tous les systèmes d'exploitation via le terminal. Le processus repose sur un flux en deux étapes : (1) entraînement unique du Personnage via `higgsfield soul-id create`, qui renvoie un `soul-id` ; (2) utilisation de cet identifiant dans les commandes de génération avec des modèles comme `text2image_soul_v2` ou `soul_cinematic`. L'assistant guide l'utilisateur pour fournir un nom et des photos (5 à 20, angles et éclairages variés), choisit la variante adaptée (Soul-2 pour images, Soul-Cinematic pour vidéo), soumet la tâche et attend silencieusement la fin de l'entraînement (jusqu'à 30 minutes). Il remet ensuite l'identifiant au moment de la génération. La compétence gère les erreurs courantes (plan gratuit, échec d'entraînement) et peut lister les Personnages existants.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Personnage IA (Higgsfield Soul Character)

Créez un modèle d'identité fidèle au visage. Réutilisable pour toutes les générations basées sur un Personnage.

Étape 0 — Amorçage

Avant toute autre commande :

  1. Si higgsfield n'est pas dans le $PATH, installez-le :
    curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
    
  2. Si higgsfield account status échoue avec Session expirée / Non authentifié, demandez à l'utilisateur d'exécuter higgsfield auth login (interactif) et attendez la confirmation.
  3. L'entraînement d'un Personnage nécessite un plan payant (Basic+). Si higgsfield account status affiche un plan gratuit, prévenez l'utilisateur avant de soumettre.

Règles UX

  1. Soyez concis. Pas d'identifiants bruts dans le chat. Dites simplement « Personnage prêt » avec une référence de nom.
  2. Détectez la langue et répondez dans celle-ci. Les indicateurs CLI restent en anglais.
  3. Demandez le plus petit ensemble d'entrées : nom + photos. Choisissez une variante de modèle sensée.
  4. L'interrogation est silencieuse — l'entraînement prend des minutes. Ne répétez pas les mises à jour de statut.

Flux de travail

  1. Obtenir le nom. Un mot, utilisé comme référence ultérieure. Demandez s'il manque.
  2. Obtenir les photos. 5 à 20 photos de visage, angles et éclairages variés. Les chemins locaux ou les identifiants déjà téléchargés fonctionnent tous les deux — --image accepte les deux.
  3. Choisir la variante.
    • --soul-2 — pour la génération d'images (par défaut)
    • --soul-cinematic — pour le travail cinématographique / vidéo Choisissez en fonction de l'utilisation aval déclarée par l'utilisateur. Par défaut --soul-2.
  4. Soumettre.
    higgsfield soul-id create --name "<nom>" --soul-2 --image ./photo1.png --image ./photo2.png ...
    higgsfield soul-id create --name "<nom>" --soul-2 --image <upload_id> --image <upload_id> ...
    
    La CLI télécharge automatiquement les chemins. Capture l'identifiant de référence retourné.
  5. Attendre. higgsfield soul-id wait <id>. Silencieux. Délai d'attente par défaut de 30 minutes.
  6. Livrer. « Personnage <nom> prêt. Utilisez dans generate avec --soul-id <id>. »

Utiliser le Personnage

Une fois entraîné, passez-le à 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

Lister les Personnages existants

higgsfield soul-id list                   # toutes les références
higgsfield soul-id get <id>               # une par identifiant

Erreurs

  • Plan Minimum Basic requis — l'utilisateur est sur le plan gratuit ; prévenez-le.
  • Échec de l'entraînement — vérifiez la qualité des photos (5+ visages uniques, bien éclairés).
  • Session expirée → higgsfield auth login.

Documentation de référence

  • references/photo-guide.md — les photos qui fonctionnent le mieux
  • references/troubleshooting.md — échecs d'entraînement courants

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).

Skills associés