Create Image Gpt Image Fal

CLI Python per gpt-image-1/gpt-image-2 su fal.ai, instradata tramite il proxy GooseWorks

di gooseworks-ai · gooseworks-ai/goose-skills

Richiede configurazione ★ 5.2/10

Create Image Gpt Image Fal — CLI Python per gpt-image-1/gpt-image-2 su fal.ai, instradata tramite il proxy GooseWorks

Cosa fa

Avvolge gli endpoint OpenAI gpt-image di fal.ai in una singola CLI Python che genera un'immagine e scrive un meta.json sidecar con modello, dimensione, qualità e stima dei costi. Seleziona gpt-image-1 (tre dimensioni fisse) o gpt-image-2 (dimensioni personalizzate fino a 3840px) e passa tra le varianti text-to-image e edit a seconda che vengano passati URL di immagini di riferimento pubblici. Si attiva quando si generano ancore di personaggi fotorealistici, keyframe di scene o fogli di storyboard progettati tramite fal.ai piuttosto che una richiesta generica di immagine.

Rapporto di test

Localizzato la skill tramite `gh api .../git/trees/HEAD?recursive=1` (l'API raw di GitHub era limitata dalla frequenza) in skills/ads/capabilities/create-image-gpt-image-fal/SKILL.md; tutti e cinque i file referenziati sono stati recuperati con HTTP 200 (scripts/generate.py 7060B, scripts/media_proxy.py 10527B, scripts/fal_helpers.py 5496B, skill.meta.json, tests/smoke-test.md). Non sono riuscito a generare un'immagine: ~/.gooseworks/credentials.json non esiste e lo script è instradato tramite un proxy GooseWorks fal-proxy a pagamento, quindi ho eseguito solo i percorsi degli argomenti offline — `--ref-image` locale esce correttamente con "ERROR: ref images must be PUBLIC URLs", `--aspect-ratio 4:5` su gpt-image-1 genera un errore con l'elenco supportato, e `--image-size 1728x2304` su gpt-image-1 stampa l'avviso documentato quindi ricade a 1024x1536 prima di bloccarsi con un traceback raw FileNotFoundError sul file di credenziali mancante (non il più amichevole "run gooseworks login" che il Preflight implica). Due difetti della documentazione verificati tramite esecuzione: la tabella delle modalità di fallimento afferma "The script rounds to /16 and caps at 3840", ma `--model gpt-image-2 --image-size 4000x4000` esce con "ERROR: image size exceeds 3840px limit"; e tests/smoke-test.md in bundle ti dice di confermare FAL_API_KEY in .env e chiama un percorso obsoleto (skills/atoms/image-generation/...) che non esiste nel repo, contraddicendo direttamente "Do not set FAL_API_KEY" di SKILL.md. Scansione di sicurezza: nessun curl|sh, nessun blob base64, nessuna esfiltrazione di terze parti — ma media_proxy.py invia il token dell'agente come parametro di query URL (?token=&agent_id=) anziché come header Authorization, il che si riversa in qualsiasi log di proxy/server. Frasi trigger giudicate: DOVREBBE attivarsi — "Generate a photoreal 9:16 anchor portrait for our ad character with gpt-image on fal" (carica), "I need a 1728x2304 designed storyboard sheet, use gpt-image-2 with a custom output size" (carica), "Here's the public URL of the approved anchor, produce the 3/4-left angle keyframe from it" (carica, variante edit); NON DOVREBBE attivarsi — "Animate this keyframe into a 5-second clip" (correttamente salta, atomo video), "Overlay the headline 'Klarify - book in 60s' onto the finished creative" (salto, ma solo perché il corpo dice di usare PIL/ffmpeg per testo leggibile — la descrizione del frontmatter "designed sheets ... where precise layout and legible text matter" tira dall'altra parte, quindi 4/5).

Testato il: 2026-07-21 · Claude Code 2.x (agent harness)

Installazione

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

Comandi e prompt di esempio

/create-image-gpt-image-falCLI Python per gpt-image-1/gpt-image-2 su fal.ai, instradata tramite il proxy GooseWorks

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

Generate a photoreal character anchor image
Create a scene keyframe with a reference image
Design a storyboard sheet with legible text

Rapporto completo →