buzz77/buzz-image

Que fait buzz-image ?

Génère et modifie des images avec GPT Image via la passerelle BUZZ à laquelle ce Claude Code est connecté. Il réutilise la propre clé BUZZ de Claude Code ; rien d'autre n'a besoin d'être installé ou configuré. Utilisez toujours le script fourni — n'écrivez jamais vos propres appels API pour les images, et ne cherchez ni n'imprimez jamais de clés API.

Répondez à l'utilisateur dans la langue qu'il utilise.

Exécution du script

Passez toujours timeout: 600000 (une image prend généralement 30 à 90 secondes ; les images grandes ou de haute qualité prennent plus de temps).

Si vous avez un outil Bash, utilisez-le. Cette forme de commande exacte est pré-approuvée :

bash ${CLAUDE_SKILL_DIR}/scripts/gen.sh -p "PROMPT" -o CHEMIN [options]

Sinon, utilisez l'outil PowerShell (typique sur Windows). Appelez le chemin du script directement comme premier mot — pas de &, pas de guillemets autour du chemin, pas de processus powershell imbriqué, rien enchaîné avant ou après — pour qu'il corresponde à la forme pré-approuvée :

${CLAUDE_SKILL_DIR}/scripts/gen.ps1 -Prompt "PROMPT" -Out CHEMIN [-Size ..] [-Quality ..] [-Background ..] [-Format ..] [-N ..] [-Ref a.png,b.png] [-Mask m.png] [-Model ..]

Si Claude Code demande toujours à l'utilisateur d'approuver la commande, c'est acceptable — attendez l'approbation ; ne cherchez jamais de solutions de contournement.

Option	Valeurs
-p	Description de l'image (obligatoire). Rédigez-la vous-même à partir de la demande de l'utilisateur.
-o	Chemin de sortie. Choisissez-en un qui correspond à l'utilisation (par ex. public/favicon.png, assets/og.png) ; sinon placez-le sous generated/. Les fichiers existants ne sont jamais écrasés (-2, -3… est ajouté).
-s	LxH exact (n'importe quelle taille, par ex. 32x32, 1200x630) ou square / landscape / portrait / wide / tall / 2k / 4k. Les tailles que le modèle ne peut pas produire directement sont générées approximativement et recadrées/mises à l'échelle localement à la taille exacte. Omettez pour laisser le modèle décider.
-b	transparent pour les découpes/autocollants/icônes sans fond (png ou webp uniquement) ; opaque ; auto.
-q	low / medium / high / xhigh / max. Omettez sauf si l'utilisateur le demande ou si l'asset nécessite des détails fins.
-f	png (par défaut) / jpeg / webp.
-n	Nombre d'images, par défaut 1.
-r	Image source/référence ; répétez pour plusieurs. Tout -r passe en mode édition.
--mask	Masque PNG pour les modifications locales (transparent = repeindre) ; nécessite -r.
-m	Modèle. Omettez pour choisir automatiquement le meilleur disponible pour la clé de l'utilisateur.
--models	Liste les modèles d'image disponibles pour cette clé, sans générer.

Le script affiche une ligne JSON. Succès : {"ok":true,"model":..,"files":[..],"size":..,"generated_size":..,"resized":..,"seconds":..}. Échec : {"ok":false,"code":..,"message":..}.

Flux de travail

1. Comprenez la demande : à quoi sert l'image, où va-t-elle, texte exact à afficher, taille, transparence. Si quelque chose d'essentiel manque, posez une courte question ; sinon allez de l'avant.
2. Utilisez des références réelles, n'inventez jamais d'actifs de marque.
   • Si l'utilisateur nomme ou joint des images ("comme cette capture d'écran", "utilisez notre logo", "correspond à ce style"), passez chacune d'elles avec -r.
   • Si l'image doit montrer ou correspondre à la marque/produit de l'utilisateur (logo, carte OG/sociale, bannière, favicon, icône d'application, tout ce qui porte le nom du produit), cherchez d'abord les actifs existants du projet — par ex. les fichiers nommés logo*, icon*, favicon*, brand*, og* dans public/, assets/, static/, src/assets/, images/, et le logo référencé dans le HTML/manifest — et passez le(s) meilleur(s) avec -r, en décrivant dans le prompt comment les utiliser ("utilisez le logo de l'image de référence exactement tel quel, ne le redessinez pas").
   • Si rien de convenable n'est trouvé, demandez à l'utilisateur son logo/référence plutôt que d'en inventer un. Ne concevez un nouveau logo que lorsque l'utilisateur le demande explicitement.
   • Les images de référence doivent être en png, jpeg ou webp ; si un logo existe uniquement en SVG, informez l'utilisateur et demandez une exportation PNG (ou poursuivez sans seulement s'il est d'accord).
3. Rédigez le prompt à partir de la description de l'utilisateur (et du contexte du projet, comme les couleurs de la marque). Conservez l'intention et le texte exact de l'utilisateur ; n'ajoutez pas d'éléments qu'il n'a pas demandés. Sauf si l'utilisateur le demande, dites au modèle de ne pas inclure de logos, marques déposées ou marques commerciales de tiers (les modèles aiment décorer les images techniques avec des logos d'entreprises connues).
4. Comptez : générez 1 image sauf si l'utilisateur en demande plus. Avant d'en générer plus de 4 en une seule fois, demandez à l'utilisateur de confirmer.
5. Modèle : laissez le script choisir sauf si l'utilisateur en nomme un. Indiquez à l'utilisateur quel modèle a été utilisé. Suggérez gpt-image-2.5-sunburst pour les modifications, le travail avec beaucoup de références ou le texte dense/précis lorsqu'il est disponible ; changez de modèle chaque fois que l'utilisateur le demande.
6. Exécutez le script.
7. Vérifiez le résultat : Lisez chaque image de sortie une fois. Rapportez à l'utilisateur : chemin(s) du fichier, modèle, taille finale, images de référence utilisées, et tout ce qui ne correspond pas à la demande (texte mal orthographié, logo modifié, mauvaise mise en page, fond non transparent…), avec une suggestion concrète. Ne régénérez pas par vous-même — l'utilisateur décide.
8. Montrez : si l'utilisateur veut voir l'image, ouvrez-la avec le visualiseur système (open sur macOS, start "" <fichier> sur Windows, xdg-open sur Linux).
9. Modifications : appliquez ce que l'utilisateur demande — régénérez avec un prompt ajusté, ou modifiez le résultat précédent avec -r <fichier précédent>. Lors de la modification, passez -s avec la taille de l'image source pour que le résultat conserve ses dimensions (sauf si l'utilisateur veut une taille différente). N'écrasez jamais l'original ; écrivez un nouveau fichier.
10. N'ajoutez pas les images générées avec git add sauf si l'utilisateur le demande.

Erreurs (code dans le JSON)

code	Que dire à l'utilisateur / faire
not_buzz	Ce Claude Code n'est pas connecté à BUZZ, donc buzz-image ne peut pas fonctionner. Arrêtez.
no_key	Aucune clé API dans la configuration de Claude Code. Arrêtez.
no_image_model	Le groupe de la clé n'a aucun modèle GPT Image ; changez le groupe de la clé dans la console BUZZ (page des clés API) pour un groupe qui inclut les modèles gpt-image. Arrêtez.
model_unavailable	Ce modèle n'est pas disponible pour la clé ; affichez available_models et laissez l'utilisateur choisir.
insufficient_balance	Solde trop faible ; rechargez dans la console BUZZ. Arrêtez.
content_policy	Transmettez le message ; laissez l'utilisateur décider comment reformuler. Ne reformulez pas et ne réessayez pas par vous-même.
timeout	Dites à l'utilisateur que le délai a expiré. Ne réessayez pas automatiquement (l'image peut déjà avoir été facturée) ; proposez de réessayer.
http_error / bad_args	Rapportez le message. Corrigez vos propres erreurs d'arguments ; ne bouclez pas.

Ne changez jamais de modèle et ne continuez pas à réessayer par vous-même après une erreur.