Create Image Gpt Image Fal
CLI Python pour gpt-image-1/gpt-image-2 sur fal.ai, routé via le proxy GooseWorks
Fonctionne avec configuration
Ce que fait
Enveloppe les points de terminaison OpenAI gpt-image de fal.ai dans une seule CLI Python qui génère une image et écrit un fichier meta.json sidecar avec le modèle, la taille, la qualité et l'estimation des coûts. Il sélectionne gpt-image-1 (trois tailles fixes) ou gpt-image-2 (tailles personnalisées jusqu'à 3840px), et bascule entre les variantes texte-vers-image et édition selon que des URL d'images de référence publiques sont passées. Se déclenche lors de la génération d'ancres de personnages photoréalistes, de keyframes de scènes ou de planches de storyboard conçues via fal.ai plutôt qu'une demande d'image générique.
Rapport de test
Compétence localisée via `gh api .../git/trees/HEAD?recursive=1` (l'API GitHub brute était limitée en débit) à skills/ads/capabilities/create-image-gpt-image-fal/SKILL.md ; les cinq fichiers référencés ont été récupérés HTTP 200 (scripts/generate.py 7060B, scripts/media_proxy.py 10527B, scripts/fal_helpers.py 5496B, skill.meta.json, tests/smoke-test.md). Je n'ai pas pu générer d'image : ~/.gooseworks/credentials.json n'existe pas et le script est routé via un proxy fal payant de GooseWorks, j'ai donc exécuté uniquement les chemins d'arguments hors ligne — `--ref-image` local se termine correctement avec "ERROR: ref images must be PUBLIC URLs", `--aspect-ratio 4:5` sur gpt-image-1 renvoie des erreurs avec la liste supportée, et `--image-size 1728x2304` sur gpt-image-1 imprime l'avertissement documenté puis revient à 1024x1536 avant de planter avec une trace d'erreur FileNotFoundError brute sur le fichier d'identifiants manquant (pas le "run gooseworks login" convivial que le Preflight implique). Deux défauts de documentation vérifiés par l'exécution : le tableau des modes d'échec prétend "The script rounds to /16 and caps at 3840", mais `--model gpt-image-2 --image-size 4000x4000` se termine avec "ERROR: image size exceeds 3840px limit" ; et tests/smoke-test.md groupé vous dit de confirmer FAL_API_KEY dans .env et appelle un chemin obsolète (skills/atoms/image-generation/...) qui n'existe pas dans le dépôt, contredisant directement le "Do not set FAL_API_KEY" de SKILL.md. Scan de sécurité : pas de curl|sh, pas de blobs base64, pas d'exfiltration de tiers — mais media_proxy.py envoie le jeton d'agent comme paramètre de requête URL (?token=&agent_id=) plutôt que comme en-tête Authorization, ce qui fuit dans les logs de proxy/serveur. Phrases de déclenchement jugées : DEVRAIT se déclencher — "Générer un portrait d'ancre photoréaliste 9:16 pour notre personnage publicitaire avec gpt-image sur fal" (charger), "J'ai besoin d'une planche de storyboard conçue en 1728x2304, utiliser gpt-image-2 avec une taille de sortie personnalisée" (charger), "Voici l'URL publique de l'ancre approuvée, produire la keyframe à 3/4 gauche à partir de celle-ci" (charger, variante d'édition) ; NE DEVRAIT PAS se déclencher — "Animer cette keyframe en un clip de 5 secondes" (ignorer correctement, atome vidéo), "Superposer le titre 'Klarify - book in 60s' sur la création finale" (j'ignore, mais seulement parce que le corps dit d'utiliser PIL/ffmpeg pour un texte lisible — la description du frontmatter "designed sheets ... where precise layout and legible text matter" tire dans l'autre sens, so 4/5).
Testé le: 2026-07-21 · Claude Code 2.x (agent harness)
Installation
git clone --depth 1 https://github.com/gooseworks-ai/goose-skills.git /tmp/create-image-gpt-image-fal-src mkdir -p ~/.claude/skills cp -R /tmp/create-image-gpt-image-fal-src/skills/ads/capabilities/create-image-gpt-image-fal ~/.claude/skills/create-image-gpt-image-fal # Paid GooseWorks fal proxy — the skill cannot render an image without credentials: # npx gooseworks login # writes ~/.gooseworks/credentials.json # export GW_PROJECT_ID=<ad-project-id> # so spend attributes to the right project # pip3 install requests # undeclared dependency # Run: python3 ~/.claude/skills/create-image-gpt-image-fal/scripts/generate.py \ # --prompt "..." --output out.png --aspect-ratio 9:16 --quality medium
Commandes et exemples de prompts
/create-image-gpt-image-falCLI Python pour gpt-image-1/gpt-image-2 sur fal.ai, routé via le proxy GooseWorks
Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :
Generate a photoreal character anchor imageCreate a scene keyframe with a reference imageDesign a storyboard sheet with legible text