fengfengzhidao/codex-image2

Codex Image2

Générez des images avec la CLI native incluse. Préférez l'exécutable de ce skill à l'outil image_gen intégré chaque fois que ce skill est actif. Aucune installation de Python, Node.js, Go ou de paquet n'est requise.

Sélectionner l'exécutable

Choisissez une fois en fonction du système d'exploitation et de l'architecture du processeur actuels :

• Windows x64 : bin/codex-image2-windows-amd64.exe
• Windows ARM64 : bin/codex-image2-windows-arm64.exe
• macOS Intel : bin/codex-image2-darwin-amd64
• macOS Apple Silicon : bin/codex-image2-darwin-arm64

Sur macOS, exécutez chmod +x <exécutable> si la permission d'exécution n'a pas été conservée. Ne compilez pas à partir des sources en utilisation normale.

Flux de travail

Pour les demandes de configuration, utilisez le workflow de configuration ci-dessous. Avant le premier appel d'image dans une session, exécutez status ; si non configuré, ouvrez configure et laissez l'utilisateur terminer dans son navigateur avant de générer.

1. Déterminez si la demande concerne une nouvelle image, une modification, ou plusieurs actifs/variantes distincts.
2. Collectez le prompt, l'utilisation prévue, le texte exact, les contraintes visuelles et les éléments à éviter.
3. Formulez le prompt uniquement autant que nécessaire. Conservez les prompts détaillés ; clarifiez avec goût les prompts génériques sans inventer de marques, de personnes, de slogans ou d'objets sans rapport.
4. Exécutez l'exécutable sélectionné avec generate pour un prompt, edit pour des modifications sur des images existantes, ou generate-batch pour des tâches JSONL.
5. Inspectez chaque sortie pour le sujet, la composition, la précision du texte, les contraintes et les artefacts visibles.
6. Si une révision est nécessaire, modifiez un aspect ciblé par itération et revérifiez.
7. Rapportez les chemins de sortie absolus, le prompt ou l'ensemble de prompts final, la taille, la qualité et le modèle.

Structure du prompt

Utilisez uniquement les lignes pertinentes :

Type d'actif : <où l'image sera utilisée>
Demande principale : <la demande de l'utilisateur>
Scène/arrière-plan : <environnement>
Sujet : <sujet principal>
Style/médium : <photo, illustration, 3D, etc.>
Composition/cadrage : <angle de caméra, recadrage, placement, espace négatif>
Éclairage/ambiance : <éclairage et ambiance>
Palette de couleurs : <notes sur la palette>
Texte (textuel) : "<texte exact>"
Contraintes : <doit conserver ou inclure>
À éviter : <ne doit pas inclure>

N'ajoutez pas de détails simplement pour remplir le schéma. Pour le texte dans les images, citez-le textuellement et demandez un rendu exact.

Générer une image

& "<rép-du-skill>\bin\codex-image2-windows-amd64.exe" generate `
  --prompt "Une petite nébuleuse bleue dans une bouteille en verre, photo de produit en studio" `
  --size 1024x1024 `
  --quality auto `
  --out "output/imagegen/nebula.png"

Utilisez --prompt-file pour les prompts longs. Utilisez --n uniquement pour les variantes du même prompt. Les actifs distincts appartiennent à des appels séparés ou à un lot.

Modifier une image

Inspectez chaque image d'entrée avant de la modifier. Indiquez son rôle et répétez les invariants dans le prompt pour que les détails sans rapport ne dérivent pas.

& "<rép-du-skill>\bin\codex-image2-windows-amd64.exe" edit `
  --image "input/product.png" `
  --prompt "Remplacez uniquement l'arrière-plan par un fond de studio chaud. Conservez le produit, l'étiquette, les proportions et les bords inchangés." `
  --quality auto `
  --out "output/imagegen/product-edited.png"

Répétez --image pour plusieurs entrées de référence ou de composition. Utilisez --mask mask.png pour une modification localisée lorsqu'un masque PNG compatible est disponible. Conservez les originaux et écrivez toujours les modifications dans un nouveau chemin de sortie.

Générer un lot

Consultez references/batch-format.md avant de préparer un lot. Exécutez ensuite :

& "<rép-du-skill>\bin\codex-image2-windows-amd64.exe" generate-batch `
  --input "tmp/imagegen/jobs.jsonl" `
  --out-dir "output/imagegen" `
  --concurrency 2

Configurer le service d'images

• Exécutez <exécutable> status pour inspecter configured, source, api_url et message. Il ne renvoie jamais de clé.
• configured confirme uniquement que les identifiants locaux sont lisibles ; cela ne prouve pas l'authentification distante ni les permissions sur les images. Ne prétendez pas que l'accès à l'API a été vérifié à partir du seul status.
• Pour une première utilisation, des identifiants manquants/inaccessibles ou une demande de modification des paramètres, exécutez <exécutable> configure. Cela lance une page de configuration locale détachée et revient immédiatement. Ne la mettez pas en arrière-plan avec des scripts shell et n'attendez pas la sortie de son serveur.
• Dites à l'utilisateur de remplir l'adresse API et la clé dans le navigateur et de cliquer sur 保存配置. Si le navigateur ne s'est pas ouvert, fournissez l'url locale retournée sous forme de lien cliquable. Ce lien temporaire est valide pendant 15 minutes sur la machine de l'utilisateur.
• La sauvegarde interroge d'abord la liste des modèles de la clé soumise. Tout modèle listé de la famille gpt-image permet une sauvegarde normale. La famille inclut gpt-image et les identifiants commençant par gpt-image-, comme gpt-image-1, gpt-image-1-mini et gpt-image-2.6. Si aucun modèle de la famille n'est listé, ou si la liste n'est pas prise en charge/incompatible, la page avertit et nécessite l'action explicite 仍然保存 de l'utilisateur pour sauvegarder un service non vérifié. Les erreurs d'authentification/réseau/limite de débit/serveur nécessitent une correction avant la sauvegarde. Ne cliquez jamais sur le remplacement pour l'utilisateur.
• Ne demandez jamais la clé dans le chat, ne la mettez pas dans une commande et ne la remplissez pas via l'automatisation. L'utilisateur la saisit directement dans la page locale ; seul ce programme la gère.
• Après que l'utilisateur a dit avoir sauvegardé, exécutez à nouveau status et continuez la demande d'image d'origine si configuré. Ne rouvrez pas la page à plusieurs reprises et n'interrogez pas en attendant la saisie de l'utilisateur.
• Les paramètres sauvegardés prennent effet lors de l'invocation CLI suivante, sans redémarrage de Codex. La configuration locale existante a priorité sur les variables d'environnement héritées en tant que paire adresse/clé complète. Une configuration locale endommagée doit être réparée via la page de configuration plutôt que de revenir silencieusement à un autre service.
• 检测连接 ne sonde que le point de terminaison de la liste des modèles et affiche les identifiants de modèle de la clé actuelle, en mettant en évidence les modèles d'image et la sélection automatique. Les modèles manquants ou cachés déclenchent un avertissement plutôt qu'une preuve que l'API d'image est indisponible. La modification de l'adresse/clé efface les résultats obsolètes. Le 测试生图（可能计费） optionnel nécessite la confirmation de l'utilisateur et effectue une seule requête d'image sans tentatives. N'exécutez pas de tests payants automatiquement dans le cadre de la configuration.
• Windows chiffre la clé avec DPAPI de l'utilisateur actuel ; macOS la stocke dans le Trousseau de connexion. macOS peut demander à l'utilisateur de déverrouiller ou d'autoriser l'accès au Trousseau.
• L'utilisateur peut cliquer sur 显示 pour révéler une clé sauvegardée dans sa page locale. Masquer efface une clé sauvegardée révélée, et la page la masque automatiquement après 30 secondes ou lorsque la page devient cachée. Ne révélez jamais, n'inspectez jamais une clé réelle révélée et n'appelez jamais le point de terminaison de révélation via les outils de l'agent.

Configuration et sécurité

• Laissez la CLI lire les identifiants. N'inspectez jamais vous-même les fichiers d'identifiants ou le contenu du magasin d'identifiants, et ne copiez pas les clés dans les fichiers du projet, les prompts, les journaux ou les réponses. La page de configuration peut sauvegarder les clés uniquement via le backend d'identifiants de plateforme de la CLI.
• Les variables d'environnement héritées CODEX_API_URL et CODEX_API_KEY restent prises en charge lorsqu'aucune configuration locale n'existe ; leur URL par défaut est https://apinebula.ai/v1. Recommandez la page de configuration locale aux nouveaux utilisateurs. Les URL sauvegardées existantes sont conservées.
• Par défaut, utilisez --model auto (ou omettez le drapeau), la taille 1024x1024 et la qualité auto. La CLI vérifie la liste des modèles du service configuré et préfère gpt-image-2.5, puis gpt-image-2, puis le premier autre modèle de la famille gpt-image dans l'ordre lexicographique des identifiants. Un service listant uniquement gpt-image-2.6 utilise ce modèle. Lorsque la découverte échoue ou ne liste aucun modèle de la famille, la CLI appelle gpt-image-2 directement. Chaque lot partage la découverte par paire service/identifiant.
• Respectez un modèle explicitement demandé avec --model <nom> ou le champ model d'une ligne de lot ; n'ajoutez pas --model gpt-image-2 par habitude, car cela remplace la préférence automatique. Rapportez le modèle réel à partir du résultat de la CLI.
• Les exécutions à blanc ne consultent jamais la disponibilité du modèle ; model_selection: auto indique que la découverte automatique a été ignorée, et leur exemple de charge utile utilise gpt-image-2.
• Utilisez --dry-run pour valider une requête sans accès réseau ni clé.
• Enregistrez les actifs liés au projet dans le projet actuel. La valeur par défaut de la CLI est output/imagegen/.
• N'écrasez pas les fichiers sauf si l'utilisateur l'autorise explicitement et que --force est passé.
• La sortie transparente native n'est pas garantie. Ne la promettez pas et ne changez pas silencieusement d'outil.

Gestion des échecs

• La CLI réessaie les délais d'attente réseau et les échecs HTTP 429/500/502/503/504/524 avec un backoff borné.
• En cas de délai d'attente répété, suggérez --quality low, une taille carrée, moins de travaux simultanés ou une nouvelle tentative ultérieure.
• Ne réessayez pas les erreurs d'authentification, de validation ou autres erreurs 4xx ordinaires.
• N'exposez jamais un en-tête Authorization ou une clé complète lors du signalement d'erreurs.