Génération d'images
python3 ~/simcraft/skills/image-gen/scripts/gen_image.py "<prompt>" --out <dossier> --name <nom> [options]
Utilise uniquement la bibliothèque standard, donc n'importe quel python3 fonctionne.
Clés
Le script lit GEMINI_API_KEY et OPENAI_API_KEY depuis l'environnement, ou depuis ~/.config/simcraft/keys.env (une NOM=valeur par ligne, chmod 600).
- Exécutez
--checkpour voir quelles clés sont définies. Il n'affiche jamais une clé. - Si aucune clé n'est définie, dites à l'utilisateur d'ouvrir le fichier lui-même (
open -e ~/.config/simcraft/keys.env) et de coller la clé dedans. Ne demandez jamais à l'utilisateur de coller une clé dans le chat, et ne lisez jamais les clés depuis les fichiers d'autres projets. - Les clés sont placées uniquement dans les en-têtes de requête. Elles ne figurent jamais dans une URL, un journal ou un fichier annexe.
- Obtenez une clé Gemini sur aistudio.google.com/apikey (elle dispose d'un niveau gratuit). Obtenez une clé OpenAI sur platform.openai.com/api-keys.
Options
| Option | Effet |
|---|---|
--n 4 | Génère 4 variations en parallèle, plus <nom>_sheet.png pour choisir. Utilisez cette option pour tout ce qui est important. |
--aspect 16:9 | Définit le format : 16:9, 9:16, 1:1, 4:3 ou 3:4. Adaptez-le à l'endroit où l'image sera utilisée. |
--ref a.png b.png | Images de référence. Utilisez-les pour modifier une image, reproduire un style ou conserver le même personnage ou objet dans plusieurs images. |
--cutout | Donne un PNG transparent pour les collages. Gemini génère sur fond vert et le script le détoure avec des bords nets. OpenAI produit une véritable transparence. |
--provider gemini|openai | Choisit le fournisseur. Par défaut : Gemini si sa clé est définie. |
--model M | Choisit le modèle. Par défaut, Gemini prend le modèle d'image le plus récent que la clé peut utiliser (--models les liste), et OpenAI utilise gpt-image-2. |
--quality low|medium|high | OpenAI uniquement. Par défaut high. |
--brand devin | Ajoute le style et la palette d'image d'une identité visuelle au prompt. Pour tout travail de marque, exécutez d'abord la compétence brand-kit. |
Chaque image reçoit un fichier <nom>.json annexe contenant le prompt exact, le modèle et les paramètres, afin qu'elle puisse être régénérée ou ajustée ultérieurement.
Quel fournisseur
- Gemini : rapide et économique. Idéal pour itérer, pour les modifications et pour assurer la cohérence avec
--ref. - OpenAI gpt-image : meilleur pour les images contenant du texte, et pour les découpes transparentes réelles.
Formulation du prompt
- Décrivez le sujet, le médium, la lumière et le cadrage, dans cet ordre. Dites ce qui doit être exclu.
- Pas de texte dans les images sauf si l'utilisateur le demande. Les modèles écrivent encore mal les mots. Ajoutez le texte ensuite dans le code.
- Pour une série, générez d'abord une image de référence unique. Puis passez cette même référence comme
--refà chaque autre image. Ne chaînez jamais l'image 2 dans l'image 3, car les petites erreurs s'accumulent. - Montrez à l'utilisateur la planche contact avant d'utiliser les images où que ce soit. Régénérez une variation au lieu de toutes les régénérer.