muend/codex-image

Génération d'images via Codex

Claude écrit la direction artistique ; gpt-6.1-sol l'exécute littéralement avec son outil d'image intégré. Le brief est le plafond de la qualité : Sol n'inventera pas bien les détails manquants, et il n'utilisera pas son « jugement » sur des questions ouvertes. Décidez tout d'abord, puis écrivez-le.

Moteur et profils de rôle

Les images proviennent de l'outil image_gen intégré de Codex avec la connexion ChatGPT Pro — pas d'API, pas de frais par image. Cet outil ne prend qu'un prompt, des images de référence et transparent_background ; le serveur choisit le modèle d'image, donc des modèles spécifiques (GPT Image 2.6 Sunburst / Flare, etc.) ne peuvent pas être sélectionnés ici. Ne passez jamais à une clé API ou au fallback CLI de Codex.

Le contrôle spécifique au rôle vient des profils dans ~/.claude/skills/codex/image-profiles.json, passés avec -ImageProfile <nom>. Un profil ajoute des notes de style de rôle au brief et peut forcer la transparence :

Profil	Utilisation	Remarques
default	tout le reste	brief uniquement
photoreal	photos de produits, bannières héros, photos éditoriales	règles de réalisme photographique
illustration	art marketing/blog/onboarding	règles d'illustration cohérentes
icon	icônes d'apps/UI, marques, stickers, sprites	transparent, padding, lisibilité à 32px
ui-asset	maquettes, visuels de tableau de bord, états vides	géométrie nette, pas de faux micro-texte
text-heavy	affiches, couvertures, infographies	typographie exacte d'abord

-Transparent fonctionne avec n'importe quel profil. Ajoutez de nouveaux rôles en ajoutant une entrée (transparent, roles, style_notes) au JSON. Le brief reste le principal levier de qualité : les profils ajoutent, jamais ne remplacent.

Flux de travail

1. Clarifiez uniquement ce qui vous bloque vraiment (but, où sera-t-elle utilisée, taille/format, texte sur l'image, couleurs de la marque). Sinon, choisissez des valeurs par défaut sensées et indiquez-les dans le brief.
2. Rédigez le brief dans un fichier du scratchpad (par ex. brief-hero.md) en utilisant le modèle ci-dessous. Remplissez chaque section ; écrivez « aucun » plutôt que de laisser une section vide.
3. Exécutez :

   pwsh -NoProfile -File "$HOME\.claude\skills\codex\scripts\codex.ps1" -Mode image `
     -PromptFile <brief.md> -Out <projet>\assets\<nom>.png [-ImageProfile icon] [-Transparent] `
     [-Count 3] [-Images ref1.png,ref2.png]
   

   Utilisez timeout: 600000. Plusieurs images différentes → une exécution en arrière-plan par image (une flotte).
4. Vérifiez vous-même : Lisez chaque fichier CODEX_IMAGE= et vérifiez-le par rapport à la checklist d'acceptation. L'auto-vérification de Codex est une affirmation, pas une preuve.
5. Itérez avec -Session <CODEX_THREAD_ID> et un court brief delta (« Gardez tout ; changez seulement : ... »), ou effectuez une modification ciblée en passant la sortie précédente avec -Images et un bref brief d'édition.
6. Livrez : montrez l'image à l'utilisateur (Read / SendUserFile), donnez le chemin et mentionnez que l'identifiant de thread est disponible pour d'autres itérations.

Modèle de brief (à copier, remplir chaque champ)

# But & utilisation
<à quoi sert cette image, où apparaît-elle (bannière héros, icône d'app, diapo, impression), public>

# Sortie
- Rapport d'aspect / taille : <ex. 16:9 paysage, 1:1 carré, 9:16 portrait ; px cible si connus>
- Format/fond : <opaque | fond transparent | solide #FFFFFF>
- Variantes : <1 | N, et comment les variantes doivent différer>

# Sujet
<sujet(s) principal(aux) en termes concrets : qui/quoi, nombre, pose, expression, action, vêtement/matière,
âge/ethnie uniquement si pertinent et spécifié par l'utilisateur>

# Composition & caméra
- Cadrage : <gros plan | plan moyen | plan large | vue de dessus | isométrique | orthographique plat>
- Placement : <position du sujet (règle des tiers, centré), espace négatif pour le texte de quel côté>
- Caméra/objectif (styles photo) : <ex. 50 mm, f/2,8 faible profondeur de champ, à hauteur d'œil>
- Avant-plan / plan intermédiaire / arrière-plan : <chacun décrit>

# Style
- Médium : <photographique | rendu 3D | vecteur plat | dessin au trait | aquarelle | pixel art | argile | isométrique ...>
- Références en mots : <époque, mouvement, texture, épaisseur de trait, niveau de détail> (pas de noms d'artistes vivants)
- Rendu : <formes minimales | modéré | très détaillé>

# Couleur & lumière
- Palette : <codes hexadécimaux avec rôles, ex. primaire #1E6FFF, accent #FFC233, fond #F5F5F7>
- Éclairage : <lumière douce venant de la gauche | éclairage trois points studio | heure dorée | lumière néon>
- Ambiance : <calme, énergique, haut de gamme, ludique ...>

# Texte dans l'image
<« aucun » OU chaque chaîne textuelle entre guillemets, avec style de police (sans empattement géométrique gras), couleur, position, taille
relative à l'image. Gardez les chaînes courtes ; l'orthographe et la casse exactes sont importantes.>

# Doit inclure
- <éléments non négociables>

# Ne doit PAS inclure
- <filigranes, texte supplémentaire, doigts supplémentaires, logos de marques réelles, encombrement, couleurs spécifiques ...>

# Instructions d'édition (uniquement lors de l'édition d'une image jointe)
- L'image 1 est : <l'image à éditer | une référence de style | une référence de sujet>
- Modifier : <exactement quoi>
- Préserver : <tout le reste qui doit rester identique : disposition, visages, couleurs, texte>

# Checklist d'acceptation
- [ ] <vérifications objectives que Claude effectuera : rapport d'aspect, sujet présent, texte exact, palette, absence de X>

Conseils de rédaction pour des résultats solides

• Les noms concrets et les attributs mesurables surpassent les adjectifs (« trois tasses en céramique, vert sauge mat #9CAF88, sur une table en noyer » ≫ « jolies tasses cosy »).
• Un seul point focal clair ; indiquez où va l'espace vide si du texte sera superposé plus tard.
• Pour les icônes/logos : plats, peu de couleurs, centrés, généreux espacement, pas de texte sauf demande, testez en petite taille.
• Pour les actifs UI/marketing : spécifiez le texte exact et gardez le texte dans l'image minimal — le vrai texte UI est mieux ajouté dans le code.
• Pour les séries/ensembles (sprites, packs d'icônes, storyboard) : rédigez une section « bible de style » commune et réutilisez-la textuellement dans chaque brief de lane pour que l'ensemble reste cohérent ; générez d'abord un héros, faites-le approuver, puis passez-le avec -Images comme référence de style pour le reste.
• Ne demandez pas la ressemblance de personnes réelles, de personnages protégés par le droit d'auteur ou de logos de marques réelles.