CommunityImagegithub.com

openai-img-gen

Générer ou modifier des images avec les modèles d'OpenAI. À utiliser lorsque l'utilisateur demande de créer, générer, dessiner ou rendre une image, illustration, maquette, concept art, idée de logo ou photo, ou de modifier, recolorer, restyler ou combiner des photos ou images existantes, même s'il ne mentionne pas OpenAI.

Qu'est-ce que openai-img-gen ?

La compétence openai-img-gen permet de générer ou modifier des images via l'API Images d'OpenAI directement depuis un terminal ou un agent IA. Elle repose sur un script Node.js (nécessite Node 18.3+) qui utilise les modèles de génération d'images d'OpenAI. Sans l'option -i, le script crée une nouvelle image ; avec -i, il édite ou combine les images fournies. Les résultats sont sauvegardés localement, avec le prompt et les métadonnées de coût et de progression affichées sur stderr. Cette compétence est utile pour les concepteurs, développeurs ou créatifs qui souhaitent intégrer la génération d'images IA dans leur flux de travail sans quitter la ligne de commande ou un assistant comme Claude Code, Cursor ou Codex. La compétence prend en charge des options avancées comme le format (png, jpeg, webp), la transparence du fond, la résolution, la qualité et le nombre d'images, ce qui la rend flexible pour des brouillons rapides ou des productions haute qualité. Elle guide également la rédaction de prompts efficaces, en insistant sur la clarté des instructions, la conservation d'éléments clés et l'évitement d'erreurs fréquentes.

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/kingfishx23/openai-img-gen/tree/HEAD/skills/openai-img-gen

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

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

Documentation

Que fait openai-img-gen ?

Le fichier index.js de ce répertoire appelle l'API Images d'OpenAI. Il ne nécessite aucune dépendance et requiert Node 18.3+.

node <ce répertoire>/index.js [options] "prompt"
node <ce répertoire>/index.js -i photo.jpg -i reference.png [options] -f prompt.txt

Sans -i, il crée une nouvelle image. Avec -i, il modifie ou combine les images fournies. Il affiche le chemin absolu de chaque fichier sauvegardé sur stdout et enregistre le prompt à côté des images sous la forme <nom>-<heure>.prompt.txt. La progression, l'utilisation des tokens, le coût et les erreurs sont envoyés sur stderr. Exécutez --help pour toutes les options. Les principales sont -p NOM (sous-dossier du projet), -o DOSSIER (dossier exact), --name PRÉFIXE, -s auto|1024x1024|1536x1024|1024x1536, -q auto|low|medium|high, -n NOMBRE, --format png|jpeg|webp et --background transparent.

Où les images sont sauvegardées : avec -p NOM, elles vont dans $OPENAI_IMG_GEN_OUT/NOM/. Le dossier de base est défini dans le fichier .env de cette compétence, sinon il s'agit du dossier courant. -o DOSSIER remplace ce chemin et sauvegarde exactement à cet emplacement.

Étapes

  1. Écrire le prompt. Pour tout ce qui dépasse une phrase, écrivez-le dans un fichier et transmettez-le avec -f. Voir "Rédaction des prompts" ci-dessous.
  2. Exécuter le script. Passez toujours -p avec un nom court pour le projet en contexte : la marque, le produit, le dépôt ou le dossier sur lequel l'utilisateur travaille (par exemple -p es-sebelas ou -p kualing), ou un sujet court s'il n'y a pas de projet. Utilisez -o uniquement lorsque l'utilisateur nomme un dossier. Utilisez un --name descriptif. Chaque appel coûte de l'argent. Une image à -q auto coûte généralement quelques centimes, et high ainsi que -n multiplient ce coût. Utilisez -q low pour les brouillons rapides, et demandez avant de créer plus de 4 images ou un grand nombre d'images haute qualité.
  3. Afficher le résultat. Ouvrez le fichier sauvegardé avec l'outil Read pour le visualiser. Vérifiez sa conformité avec le prompt (orthographe du texte, éléments qui devaient rester identiques), puis indiquez à l'utilisateur le chemin, ce que vous voyez et la ligne de coût.
  4. Itérer. Modifiez le prompt en fonction de ce qui a mal fonctionné, et maintenez le fichier de prompt à jour pour qu'il corresponde au meilleur résultat.

S'il n'y a pas de clé API, dites à l'utilisateur de définir OPENAI_API_KEY, ou de copier .env.example dans le répertoire de cette compétence vers .env et de le remplir. Ne demandez jamais de coller la clé dans le chat. Si une requête est bloquée par la modération, rapportez la raison affichée par le script et suggérez un prompt reformulé. Ne réessayez pas le même prompt.

Rédaction des prompts

  • Dites à quoi sert chaque image d'entrée, dans l'ordre : "La PREMIÈRE image est une RÉFÉRENCE DE COULEUR UNIQUEMENT. Ne copiez pas sa disposition, ses formes ou son texte. La DEUXIÈME image est la photo à modifier. Conservez son cadrage et son format."
  • Donnez une tâche claire, puis listez exactement ce qu'il faut modifier, avec des valeurs concrètes (couleurs hex, matériaux, positions).
  • Listez ce qui doit rester identique. Pour les modifications, dites "Gardez tout le reste exactement tel quel" et nommez les éléments qui ne doivent pas dériver : angle de la caméra, éclairage, arrière-plan, personnes, autres bâtiments.
  • Citez tout texte qui doit apparaître, avec l'orthographe exacte ("lit exactement "ES SEBELAS""). Demandez peu de texte : les modèles d'image écorchent les longs textes.
  • Nommez le style : photoréaliste, vecteur plat, aquarelle, rendu 3D, etc.
  • Terminez par une ligne "Éviter :" pour l'échec auquel vous vous attendez, comme du texte supplémentaire, la copie de la disposition de la référence, ou la modification de quoi que ce soit en dehors de la cible.
  • Les logos et icônes sur fond uni ou transparent : --background transparent --format png.

Skills associés