Create Image Gpt Image Fal

Python CLI für gpt-image-1/gpt-image-2 auf fal.ai, geroutet über den GooseWorks Proxy

von gooseworks-ai · gooseworks-ai/goose-skills

Funktioniert mit Setup ★ 5.2/10

Create Image Gpt Image Fal — Python CLI für gpt-image-1/gpt-image-2 auf fal.ai, geroutet über den GooseWorks Proxy

Was es kann

Umschließt fal.ai's OpenAI gpt-image-Endpunkte in einer einzigen Python CLI, die ein Bild generiert und eine Sidecar meta.json mit Modell, Größe, Qualität und Kostenschätzung schreibt. Es wählt gpt-image-1 (drei feste Größen) oder gpt-image-2 (benutzerdefinierte Größen bis zu 3840px) und wechselt zwischen den Text-zu-Bild- und Bearbeitungsvarianten, je nachdem, ob öffentliche Referenzbild-URLs übergeben werden. Wird ausgelöst beim Generieren von fotorealistischen Charakter-Ankern, Szenen-Keyframes oder entworfenen Storyboard-Blättern über fal.ai anstatt einer generischen Bildanfrage.

Testbericht

Der Skill wurde über `gh api .../git/trees/HEAD?recursive=1` (rohe GitHub API war ratenbegrenzt) unter skills/ads/capabilities/create-image-gpt-image-fal/SKILL.md gefunden; alle fünf referenzierten Dateien wurden mit HTTP 200 abgerufen (scripts/generate.py 7060B, scripts/media_proxy.py 10527B, scripts/fal_helpers.py 5496B, skill.meta.json, tests/smoke-test.md). Ich konnte kein Bild generieren: ~/.gooseworks/credentials.json existiert nicht und das Skript wird über einen kostenpflichtigen GooseWorks fal-Proxy geroutet, daher habe ich nur die Offline-Argumentpfade ausgeführt — lokales `--ref-image` beendet korrekt mit „ERROR: ref images must be PUBLIC URLs“, `--aspect-ratio 4:5` bei gpt-image-1 führt zu Fehlern mit der unterstützten Liste, und `--image-size 1728x2304` bei gpt-image-1 druckt die dokumentierte Warnung und fällt dann auf 1024x1536 zurück, bevor es mit einem rohen FileNotFoundError-Traceback auf die fehlende Anmeldeinformationsdatei abstürzt (nicht das freundliche „run gooseworks login“, das der Preflight impliziert). Zwei durch die Ausführung verifizierte Dokumentationsfehler: Die Tabelle der Fehlermodi behauptet „The script rounds to /16 and caps at 3840“, aber `--model gpt-image-2 --image-size 4000x4000` beendet mit „ERROR: image size exceeds 3840px limit“; und die gebündelte tests/smoke-test.md weist an, FAL_API_KEY in .env zu bestätigen und ruft einen veralteten Pfad (skills/atoms/image-generation/...) auf, der im Repo nicht existiert, was SKILL.mds „Do not set FAL_API_KEY“ direkt widerspricht. Sicherheitsscan: kein curl|sh, keine base64-Blobs, keine Drittanbieter-Exfiltration — aber media_proxy.py sendet das Agenten-Token als URL-Abfrageparameter (?token=&agent_id=) statt als Authorization-Header, was in alle Proxy-/Server-Logs gelangt. Trigger-Formulierungen bewertet: SOLLTE auslösen — „Generiere ein fotorealistisches 9:16 Ankerporträt für unseren Werbecharakter mit gpt-image auf fal“ (laden), „Ich brauche ein 1728x2304 entworfenes Storyboard-Blatt, verwende gpt-image-2 mit einer benutzerdefinierten Ausgabegröße“ (laden), „Hier ist die öffentliche URL des genehmigten Ankers, produziere den 3/4-Links-Winkel-Keyframe daraus“ (laden, Bearbeitungsvariante); SOLLTE NICHT auslösen — „Animieren Sie diesen Keyframe in einen 5-Sekunden-Clip“ (korrekt überspringen, Video-Atom), „Überlagern Sie die Überschrift 'Klarify - book in 60s' auf das fertige Kreativ“ (ich überspringe, aber nur weil der Text sagt, PIL/ffmpeg für lesbaren Text zu verwenden — die Frontmatter-Beschreibung „designed sheets ... where precise layout and legible text matter“ zieht in die andere Richtung, also 4/5).

Getestet am: 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

Befehle & Beispiel-Prompts

  • /create-image-gpt-image-falPython CLI für gpt-image-1/gpt-image-2 auf fal.ai, geroutet über den GooseWorks Proxy

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

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