chirag2653/openai-image-generation

Was macht openai-image-generation?

Installierbare KI-Agenten-Fähigkeit zur Bildgenerierung mit OpenAIs gpt-image-2 über eine getestete Python-CLI (--json-Modus, Exit-Code-Vertrag, 4-stufige API-Key-Erkennung).

Übersicht

Dieses Skill ermöglicht es KI-Agenten, Bilder mittels des OpenAI gpt-image-2 Modells zu generieren. Es stellt eine Python-CLI zur Verfügung, die sowohl für Menschen als auch für automatisierte Systeme geeignet ist.

Plattformen

• Claude Code
• Cursor
• Codex

Hauptfunktionen

• Bildgenerierung: Erstellen von Bildern aus Textbeschreibungen mit gpt-image-2
• JSON-Modus: Strukturierte Ausgabe für einfache Verarbeitung durch Skripte und Tools
• Exit-Code-Vertrag: Klare Rückgabecodes (0 für Erfolg, 1 für Fehler)
• API-Key-Erkennung: 4-stufige Suche:
  1. OPENAI_API_KEY Umgebungsvariable
  2. .env Datei im aktuellen Verzeichnis
  3. ~/.openai/config Konfigurationsdatei
  4. Direkte Eingabe über den --api-key Parameter

Installation

pip install openai-image-generation

Verwendung

# Einfaches Beispiel
openai-image --prompt "Ein fliegender Drache über einer Burg"

# Mit JSON-Ausgabe
openai-image --prompt "Ein sonniger Strand" --json

# Benutzerdefinierte Größe
openai-image --prompt "Ein Wald im Herbst" --size 1024x1024

CLI-Optionen

Option	Beschreibung
--prompt	Textbeschreibung des gewünschten Bildes (erforderlich)
--json	Ausgabe im JSON-Format
--size	Bildgröße (z.B. 1024x1024, Standard: 1024x1024)
--api-key	OpenAI API-Key (optional, falls nicht in Umgebung)

Exit-Codes

• 0: Erfolg
• 1: Fehler (z.B. ungültiger API-Key, Netzwerkproblem, ungültige Eingabe)

Testen

pytest tests/

Lizenz

MIT