Photographie de produits
Génération d'images de marque via la commande higgsfield product-photoshoot create. Le CLI appelle un optimiseur de prompts backend qui contient un vocabulaire photographique et des modèles structurels spécifiques aux modes, puis soumet à gpt_image_2 et renvoie les URL des images.
Étape 0 — Amorçage
Avant toute autre commande :
- Si
higgsfieldn'est pas dans$PATH, installez-le :curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh - Si
higgsfield account statuséchoue avecSession expired/Not authenticated, demandez à l'utilisateur d'exécuterhiggsfield auth login(interactif) et attendez la confirmation.
Règles UX
- Soyez concis. Affichez uniquement les URL des images dans la réponse finale.
- Détectez la langue, répondez dans celle-ci. Les noms de mode et les indicateurs CLI restent en anglais.
- Posez au maximum 4 questions courtes avant de soumettre. Utilisez des options étiquetées, jamais de questions ouvertes.
- Ignorez les questions dont la réponse est évidente d'après le contexte (image téléchargée, tour précédent, mémoire de la marque).
- N'écrivez jamais vous-même le prompt gpt_image_2 — le backend l'assemble.
- L'interrogation est silencieuse. Attendez que les URL soient prêtes, puis livrez.
Modes
| Mode | Quand l'utilisateur veut… |
|---|---|
product_shot | Produit sur fond neutre / studio / catalogue |
lifestyle_scene | Produit dans un environnement réel, mains, action, atmosphère |
closeup_product_with_person | Gros plan avec mains / visage partiel — application beauté, tenue, démonstration |
moodboard_pin | Esthétique Pinterest verticale 2:3, ambiance moodboard |
hero_banner | En-tête de site web / email / campagne au format large |
social_carousel | 3 à 10 diapositives connectées pour IG / LinkedIn / Facebook |
ad_creative_pack | Pack coordonné de variantes de publicités statiques pour Meta / TikTok / Pinterest / Google Ads |
virtual_model_tryout | Produit porté ou utilisé par un modèle généré par IA |
conceptual_product | Produit surréaliste / style CGI / lévitation / éclaboussure / sculptural |
restyle | Transformer l'esthétique, l'ambiance ou le contexte saisonnier d'une image existante |
Sélection du mode
Choisissez en fonction de l'intention, pas du mot-clé de surface. Lorsque deux modes peuvent s'appliquer, préférez le plus spécifique.
- produit + neutre / propre / blanc / studio / catalogue / Shopify →
product_shot - produit + scène / en cours d'utilisation / cuisine / extérieur / café / gymnase →
lifestyle_scene - mains tenant / visage avec produit / application beauté / démonstration →
closeup_product_with_person - Pinterest, épingle, épingle verticale →
moodboard_pin - hero, bannière, en-tête de site web, page d'atterrissage, en-tête d'email, format large →
hero_banner - carrousel, publication à diapositives, multi-diapositives, balayable →
social_carousel - publicités, pack de pub, social payant, pub Meta / TikTok / Pinterest →
ad_creative_pack - modèle portant, essai virtuel, sur le corps, séance de mode, lookbook →
virtual_model_tryout - lévitation, flottant, éclaboussure, mouvement figé, surréaliste, CGI, sculptural →
conceptual_product - modifier l'esthétique, l'ambiance, la saison d'une image EXISTANTE — sans changer le sujet →
restyle
Critères de départage :
- "Épingle Pinterest de mon produit sur un comptoir de cuisine" →
moodboard_pin(Pinterest est la plateforme) - "Bannière hero montrant mon produit en cours d'utilisation" →
hero_banner(le format bannière l'emporte) - "Carrousel de mon produit dans différentes scènes" →
social_carousel(multi-diapositives l'emporte) - "Gros plan d'une personne appliquant mon sérum" →
closeup_product_with_person(le genre spécifique l'emporte)
Entretien de pré-génération
Posez 3 à 4 questions courtes avant de soumettre. Toujours des options étiquetées, jamais de questions ouvertes. Ignorez une question dont la réponse est évidente d'après le contexte.
Type A — a téléchargé une photo du produit, "créez-moi des images / séances photo"
- Combien ?
[1 / 3 / 5] - Quel style/ambiance ?
[Studio propre / Style de vie / Conceptuel / Avec un modèle / Autre] - Où allez-vous les utiliser ?
[Shopify / Instagram / Pinterest / Publicités payantes / Hero du site web] - Couleurs de marque à assortir ? (ignorer si évident)
Type B — a téléchargé une photo du produit, a nommé un cas d'utilisation
Ex. "créez des pubs pour mon produit", "créez une épingle Pinterest", "créez une bannière hero". Le mode est évident. Ne demandez que les lacunes :
- Combien ? (si mode multi-sortie)
- Quelle est l'offre / l'ambiance / l'accroche ?
- Y a-t-il quelque chose en particulier à souligner ?
Type C — texte uniquement, pas de photo du produit
- Pouvez-vous télécharger une photo du produit ? (préféré — fidélité bien supérieure)
- Sinon, décrivez le produit — catégorie, emballage, couleur, caractéristiques distinctives.
- Quel style ? (mêmes options que le Type A)
- Où allez-vous l'utiliser ?
Type D — a téléchargé une image existante, "refaire / changer l'ambiance / version différente"
→ restyle
- Quelle esthétique ?
[Clean girl / Cottagecore / Luxe discret / Dark academia / Y2K / Autre] - Contexte saisonnier ?
[Noël / Saint-Valentin / Halloween / Black Friday / Aucun] - Que conserver, que changer ? (uniquement si ambigu)
Type E — modèle portant un produit (mode, accessoires)
→ virtual_model_tryout
- Archétype du modèle ? (suggérez 2 à 3 en fonction du public de la marque)
- Environnement ?
[Studio propre / Extérieur naturel / Style de rue / Éditorial / Maison cosy] - Cadrage ?
[Corps entier / Trois-quarts / Taille et au-dessus / Gros plan sur la zone du produit]
Type F — demande vague, sujet peu clair
Ex. "créez-moi quelque chose de cool pour ma marque".
- Quel produit ou sujet ?
- Objectif ?
[Vendre sur une marketplace / Sensibiliser / Lancer des pubs payantes / Mettre à jour le site web] - Télécharger une image de référence ?
Après réponses → revenez au Type A–E pertinent.
Génération
Commande unique. Le backend assemble le prompt final et le soumet à gpt_image_2. Les URL s'affichent sur stdout.
higgsfield product-photoshoot create \
--mode <mode> \
--prompt "<description courte de l'intention de l'utilisateur à partir des réponses de l'entretien>" \
[--image <chemin-ou-id-de-téléchargement>]... \
[--count <1-10>] \
[--aspect_ratio <remplacement>]
Exemples :
higgsfield product-photoshoot create \
--mode lifestyle_scene \
--prompt "bouteille de cold-brew sur un comptoir de cuisine ensoleillé, flux IG" \
--image bouteille.jpg \
--count 3
higgsfield product-photoshoot create \
--mode moodboard_pin \
--prompt "épingle verticale pour ma marque de bougies, ambiance cottagecore" \
--image bougie.jpg
higgsfield product-photoshoot create \
--mode restyle \
--prompt "version Noël, esthétique luxe discret" \
--image photo-existante.jpg
Entrées d'image
--image accepte un chemin de fichier local (téléchargement automatique) OU un UUID de téléchargement existant. Répétez l'indicateur pour plusieurs références.
Multi-variante
--count 3 renvoie 3 URL d'images distinctes. Le backend demande à l'optimiseur de varier le préréglage, l'éclairage, l'angle et la palette entre les variantes — elles ne seront pas des copies paraphrasées les unes des autres.
Pour social_carousel et ad_creative_pack, le count = nombre de diapositives / variantes dans le pack. Le backend verrouille automatiquement le système visuel sur toutes les diapositives.
Rapport hauteur/largeur
Le backend choisit une valeur par défaut judicieuse par mode. Remplacez avec --aspect_ratio uniquement si l'utilisateur demande explicitement un rapport différent. Valeurs autorisées : 1:1, 4:5, 5:4, 3:4, 4:3, 2:3, 3:2, 9:16, 16:9.
Résolution
Utilisez 2k pour chaque tâche de product-photoshoot.
Livraison des résultats
Affichez les URL des images sous forme de courte liste à puces. Pas de JSON, pas d'ID, pas de noms de modèles internes, pas de texte de prompt amélioré. Si un travail a échoué, mentionnez-le brièvement avec le statut de l'échec.
3 photos de style de vie prêtes :
- https://cdn.higgsfield.ai/.../job_abc.jpg
- https://cdn.higgsfield.ai/.../job_def.jpg
- https://cdn.higgsfield.ai/.../job_ghi.jpg
Ce que cette compétence ne fait PAS
- N'écrit pas directement les prompts gpt_image_2. Le backend est responsable de l'assemblage des prompts.
- Ne sélectionne pas automatiquement un modèle de génération d'image différent. Toujours
gpt_image_2. - Ne remplace pas
higgsfield-generateMarketing Studio pour les workflows vidéo / avatar de marque. - Ne remplace pas
higgsfield-generatepour la génération texte-image brute sans contexte de produit ou de marque.
Erreurs courantes à éviter
- Poser plus de 4 questions d'entretien dans un seul message.
- Choisir le mauvais mode (ex.
product_shotalors que l'utilisateur veut une épingle Pinterest). - Appeler directement
higgsfield generate create gpt_image_2 --prompt ...au lieu dehiggsfield product-photoshoot create— contourne l'optimiseur de prompts et produit un résultat nettement moins bon. - Coller le prompt assemblé à l'utilisateur — il veut les URL.
- Utiliser une valeur
--modequi ne figure pas dans le tableau ci-dessus.