Chapter 4 · Chapitre 4 · Utiliser Claude Code pour organiser et réutiliser ses règles graphiques
4.4 Brancher un générateur d'images par API
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freePour que Claude Code puisse générer des images, il lui faut un accès à un générateur. Nous utilisons ici l'API d'images d'OpenAI, mais le principe est le même avec un autre fournisseur qui propose une API.
Étape 1 : obtenir une clé
L'API est un service distinct de l'abonnement ChatGPT : ton abonnement ChatGPT ne donne pas accès à l'API. Il faut :
- te connecter sur la plateforme développeurs d'OpenAI (platform.openai.com) ;
- ajouter un moyen de paiement ou du crédit (la facturation se fait à l'usage) ;
- créer une clé dans la rubrique des clés d'API, et la copier immédiatement (elle ne s'affiche qu'une fois).
Pour certains modèles d'image, OpenAI peut demander de vérifier ton organisation : si la génération est refusée avec un message à ce sujet, c'est là qu'il faut aller.
Étape 2 : ranger la clé en sécurité
Ajoute une ligne dans le fichier .env de ton projet :
OPENAI_API_KEY=ta-cle-ici
Trois règles : ne colle jamais la clé dans une conversation, n'envoie jamais le fichier .env à quelqu'un, et si ton projet est sur GitHub, ajoute .env au fichier .gitignore. Si tu penses qu'une clé a fuité, supprime-la sur la plateforme et crée-en une nouvelle.
Étape 3 : laisser Claude Code écrire le script
Demande-lui simplement :
Écris un script generer.mjs (Node.js) qui :
- lit OPENAI_API_KEY dans .env sans jamais l'afficher ;
- lit prompts/base.md et remplace {SUJET} par le sujet passé en argument ;
- appelle l'API de génération d'images d'OpenAI en portrait 1024x1536 ;
- enregistre l'image reçue dans images/ ;
- ajoute une ligne dans prompts/journal.md.
Vérifie dans la documentation d'OpenAI le nom du modèle et les paramètres acceptés.
Pour les visuels de cette formation, nous avons utilisé l'endpoint de génération d'images avec le modèle gpt-image-2, la taille 1024x1536 et la qualité high ; l'image revient encodée (base64) et le script l'enregistre en PNG. Les noms de modèles évoluent : demande toujours à Claude Code de vérifier la documentation actuelle.
Étape 4 : tester
Génère un visuel avec le sujet : « une tasse en céramique crème sur un plan de travail en bois ».
Claude Code demande l'autorisation d'exécuter le script (c'est normal : il te montre ce qu'il va lancer), puis te donne le chemin de l'image. Ouvre-la et compare-la au guide.
Erreurs fréquentes : clé mal copiée (espace en trop), pas de crédit sur le compte, organisation non vérifiée, taille non acceptée par le modèle. Le message d'erreur renvoyé par l'API indique presque toujours la cause : demande à Claude Code de te l'expliquer.