Communitygithub.com

Louissagan/codex-image-studio-skill

Compétence Codex pour la génération/édition d'images via des relais compatibles OpenAI ou les API restreintes gpt-image-2 de Running Hub.

Qu'est-ce que codex-image-studio-skill ?

Cette compétence pour Codex permet de générer et éditer des images directement depuis la ligne de commande, en utilisant soit des relais compatibles avec les API d'OpenAI (comme `gpt-image-2` ou des endpoints équivalents), soit les API restreintes du Running Hub. Elle est particulièrement utile pour les développeurs et utilisateurs d'agents IA qui souhaitent intégrer la création d'images dans leurs workflows sans quitter leur terminal. La compétence se base sur une fonctionnalité d'appel d'API REST simple, nécessitant la configuration de variables d'environnement (`OPENAI_API_KEY`, `RUNNING_HUB_API_KEY`, etc.). Elle supporte la génération d'images à partir de prompts textuels, ainsi que l'édition (inpainting, outpainting) via des masques ou des zones. Son fonctionnement est documenté via le fichier `SKILL.md` qui décrit les commandes, les paramètres et les exemples d'utilisation.

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add Louissagan/codex-image-studio-skill

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 codex-image-studio-skill ?

Compétence Codex pour la génération/édition d'images via des relais compatibles OpenAI ou les API restreintes gpt-image-2 de Running Hub.

Aperçu

Cette compétence permet aux agents Codex de générer et modifier des images en utilisant des appels API REST.

Plateformes supportées

  • OpenAI-compatible relays : Utilisez tout fournisseur implémentant l'interface /v1/images/generations d'OpenAI.
  • Running Hub : Utilise les API restreintes gpt-image-2.

Configuration

Définissez les variables d'environnement suivantes :

  • OPENAI_API_KEY : Clé API pour les relais compatibles OpenAI.
  • RUNNING_HUB_API_KEY : Clé API pour Running Hub (si applicable).
  • BASE_URL (optionnel) : URL de base personnalisée pour le relais (par défaut, l'API OpenAI).

Utilisation

Générer une image

codex --skill generate-image "un chat volant dans l'espace"

Éditer une image

codex --skill edit-image --image-path /chemin/image.png --mask-path /chemin/masque.png --prompt "remplacer le fond par une forêt"

Paramètres

  • --prompt (requis) : Description textuelle de l'image.
  • --image-path (requis pour l'édition) : Chemin vers l'image source.
  • --mask-path (optionnel) : Chemin vers un masque pour l'inpainting.
  • --size (optionnel) : Dimensions de l'image (ex: 1024x1024).
  • --n (optionnel) : Nombre d'images à générer (défaut : 1).

Exemple complet

# Génération simple
export OPENAI_API_KEY=votre_cle_api
codex --skill generate-image "un paysage de montagne au coucher du soleil" --size 1024x1024 --n 1

Notes

  • Les clés API ne doivent jamais être commitées dans le code.
  • Les images générées sont sauvegardées localement dans le dossier courant, sauf indication contraire.
  • Cette compétence nécessite une connexion réseau.

Licence

MIT

Skills associés