| name | ai-create-image |
| description | Foto/Illustration/Poster via OpenAI gpt-image-1. Trigger bei 'create-image', 'erzeuge bild', 'mach ein bild', 'poster', 'illustration', 'generiere foto', 'produziere ein visual'. Schreibt PNG nach output/YYYY-MM-DD/. |
| argument-hint | <prompt> [--size 1024x1024|1024x1536|1536x1024|auto] [--quality low|medium|high|auto] [--out NAME] |
/ai-create-image -- Bilder via OpenAI gpt-image-1
Text-Prompt rein, PNG raus. gpt-image-1 ist der Nachfolger von DALL-E 3 -- besseres Text-Rendering, besserer Fotorealismus. Wrapper laeuft cross-platform ueber Node.
Wann nutzen
- Heldenbild fuer Folie, Blog, Landing-Page
- Poster / Eventbild
- Editorial-Illustration zu einem Thema
- Schnelle Visualisierung einer Idee (Whiteboard-Ersatz)
Voraussetzungen
- Node.js >= 18 (mit built-in
fetch)
- OPENAI_API_KEY (Aufloesung siehe weiter unten)
Wird vom Preflight automatisch geprueft (inkl. Live-Test des Keys gegen /v1/models).
($SKILL = Pfad zum Skill-Ordner, typisch ~/.claude/skills/ai-create-image)
Install-Gate (vor jedem Aufruf!)
if [ -f "$SKILL/SKILL_INSTALLED.md" ]; then
:
elif [ -f "$SKILL/SKILL_INSTALL_FAILED.md" ]; then
cat "$SKILL/SKILL_INSTALL_FAILED.md"; exit 1
else
bash "$SKILL/scripts/preflight.sh"
fi
# Windows:
if (Test-Path "$SKILL\SKILL_INSTALLED.md") { }
elseif (Test-Path "$SKILL\SKILL_INSTALL_FAILED.md") { Get-Content "$SKILL\SKILL_INSTALL_FAILED.md"; exit 1 }
else { powershell -ExecutionPolicy Bypass -File "$SKILL\scripts\preflight.ps1" }
bin/create-image.mjs prueft den Gate ohnehin selbst -- bei fehlendem Marker verweigert es die Arbeit mit klarer Meldung.
Ausfuehrung
node "$SKILL/bin/create-image.mjs" "DEIN PROMPT"
Output:
output/YYYY-MM-DD/<name>.png
output/YYYY-MM-DD/<name>.prompt.txt
Wrapper gibt JSON zurueck mit png, prompt_file, size, quality, model, bytes, key_source, created_at.
Optionen
| Flag | Beschreibung | Default |
|---|
--size SIZE | 1024x1024, 1024x1536, 1536x1024, auto | 1024x1024 |
--quality LEVEL | low, medium, high, auto | high |
--out NAME | Output-Dateiname (ohne .png) | img-<HHMMSS> |
--cwd DIR | Basisverzeichnis -- Output landet in <cwd>/output/YYYY-MM-DD/ | process.cwd() |
--model NAME | Modell-Override | gpt-image-1 |
-h, --help | Hilfe | – |
Size / Quality (Faustregeln)
| Size | Zweck | Kosten-Tendenz |
|---|
1024x1024 | Square Post, Icon, Avatar | mittel |
1024x1536 | Portrait / Poster hochkant | hoeher |
1536x1024 | Landscape / Banner | hoeher |
auto | Modell entscheidet | variabel |
| Quality | Nutzen |
|---|
low | Schnell, Preview, Thumbnails |
medium | Standard |
high (Default) | Print, Folien, Heldenbild |
auto | Modell entscheidet |
API-Key-Reihenfolge
~/.claude/.env/ai-create-image.env -- Override pro Nutzer<skill>/config/secrets.default.env -- shipped default (mitgeliefert)$OPENAI_API_KEY -- Umgebungsvariable
Format:
OPENAI_API_KEY=sk-...
Prompt-Tipps fuer gpt-image-1
- Konkret: Subjekt, Setting, Licht, Stil, Farbpalette, Blickwinkel
- Text im Bild funktioniert ordentlich (Posterschrift, Schilder); bei Logos vorsichtig
- Fotorealistisch: "professional photography, natural lighting, shallow depth of field, 50mm lens"
- Illustration: "editorial illustration, flat design, limited color palette (2-3 colors), clean lines"
- Technical: "technical illustration, engineering aesthetic, muted blues and greys, clear focal point"
Beispiele
Business-Heldenbild
node "$SKILL/bin/create-image.mjs" --size 1536x1024 --out hero-team \
"A team of consultants in a modern light-filled office, whiteboard with diagrams,
warm natural light, documentary photography style, focus on collaboration,
no faces visible clearly."
Event-Poster
node "$SKILL/bin/create-image.mjs" --size 1024x1536 --out lagerfeuer-poster \
"Vintage-style event poster for 'Lagerfeuer 2026 - KI im Mittelstand',
bold sans-serif typography, warm orange + dark teal color scheme,
stylized illustration of a campfire with abstract neural network sparks,
centered composition, A3 portrait aspect, editorial feel."
Editorial-Illustration
node "$SKILL/bin/create-image.mjs" --size 1536x1024 --quality high --out blog-system \
"Editorial illustration, minimal flat vector style, two consultants looking at a giant
interconnected system (gears + nodes + people), limited palette (#0b6bcb blue, #ea580c
orange, soft grey), 3:2 aspect, clear focal point."
Fehlerfaelle
Erste Anlaufstelle: SKILL_INSTALL_FAILED.md im Skill-Ordner (falls vorhanden).
| Symptom | Ursache | Loesung |
|---|
ERROR: Skill noch nicht installiert | Preflight nicht gelaufen | bash "$SKILL/scripts/preflight.sh" |
HTTP 401 | API-Key falsch / abgelaufen | ~/.claude/.env/ai-create-image.env aktualisieren oder Skill-Default ersetzen |
HTTP 429 | Rate-Limit | 30 s warten, retry |
content_policy_violation | Prompt enthaelt verbotenes Motiv | Umformulieren (Gewalt, reale Personen kompromittierend, medizinische Diagnosen) |
HTTP 500 | OpenAI-seitig | 1-2 min warten, retry |
Healthcheck (read-only):
node "$SKILL/scripts/doctor.mjs"
Kosten
Pro Bild (grobe Hausnummern):
1024x1024 standard: $0.04 – 0.051024x1536 / 1536x1024: $0.06 – 0.08high quality verdoppelt das in etwa.
Faustregel: 10 Iterationen = ca. 50 Cent.
Anti-Patterns
- Keine realen Personen ohne Einverstaendnis erzeugen ("Kunde X im Portraitstil" -> nein).
- Keine Logos -- gpt-image-1 kann Marken-Logos nicht zuverlaessig reproduzieren. Dafuer Designer.
- Nicht als "Foto von Fakt X" verkaufen -- Bilder sind immer synthetisch.
Architektur
~/.claude/.env/ai-create-image.env # API-Key Override (pro Nutzer)
$SKILL/config/secrets.default.env # shipped default
<cwd>/output/YYYY-MM-DD/<name>.png # Output
<cwd>/output/YYYY-MM-DD/<name>.prompt.txt # verwendeter Prompt (Reproduzierbarkeit)
Dokumentation
