agorum_ai_agents_library_basic_create_edit_image_openai

Hinweise:

Diese Dokumentation bezieht sich auf die aktuellste Version des Plugins ALBERT | AI Agents. Aktualisieren Sie das hier beschriebene Plugin, um die Dokumentation verwenden zu können.
Wie Sie die KI-Tools in Ihren KI-Voreinstellungen verwenden, erfahren Sie hier: ALBERT | AI agents tools einrichten

Anzeigename: Creates or edits an image with OpenAI image models (e.g. gpt-image-2)

Hinweis: Für die Verwendung des Tools agorum_ai_agents_library_basic_create_edit_image_openai müssen Sie einen API-Key für den Zugriff auf die OpenAI-Bildgenerierung in den Einstellungen des Tools hinterlegen.

Was macht das Tool?

Dieses Tool erstellt oder bearbeitet ein Bild auf Basis eines Prompts (Textbeschreibung) oder vorhandener Bilddateien. Die Bildgenerierung erfolgt mit den Bildmodellen von OpenAI (z. B. gpt-image-2). Werden ein oder mehrere Bilder als Eingabe übergeben, wird der Bildbearbeitungsmodus (Edit) verwendet. Andernfalls wird ein neues Bild generiert. Das Ergebnis wird als Bild im agorum core gespeichert und es werden sowohl ein direkter Link zum Objekt als auch ein Bildlink zur Anzeige bereitgestellt.

Empfohlener Einsatzzweck

Das Tool eignet sich, um aus Textbeschreibungen (Prompts) neue Bilder zu generieren oder bestehende Bilder zu verändern. Es ist besonders nützlich für kreative Aufgaben, Marketing, Content-Erstellung oder überall dort, wo schnell und einfach KI-generierte Bilder benötigt werden. Im Vergleich zum Gemini-Tool bietet das OpenAI-Tool zusätzliche Parameter wie transparente Hintergründe, Moderationssteuerung, Ausgabeformat und Komprimierung.

Funktionsbeschreibung

Parameter	Beschreibung
prompt (Pflicht)	Der Textprompt, der das zu erstellende oder zu bearbeitende Bild beschreibt. Dieser Parameter ist erforderlich und sollte eine klare und detaillierte Beschreibung des gewünschten Bildes enthalten.
model (Pflicht)	Das zu verwendende Modell für die Bildgenerierung, z. B. `gpt-image-2`.
url (Optional, vorgegeben)	Die Basis-URL des OpenAI-API-Endpunkts. Standard: `https://api.openai.com`
apiKey (Pflicht)	API-Key für den Zugriff auf den externen OpenAI-Service. Hinweis: Die Erstellung eines OpenAI-Kontos und eines API-Keys für die Bildgenerierung ist erforderlich und ggf. kostenpflichtig.
imageUuids (Optional)	Liste von UUIDs bereits vorhandener Bilder, die als Grundlage für die Bearbeitung oder für Bild-zu-Bild-Generierung verwendet werden. Wenn angegeben, wird der Edit-Endpunkt von OpenAI verwendet (Multipart-Upload). Andernfalls wird der Generierungs-Endpunkt genutzt.
size (Optional)	Die Größe des generierten Bildes. Erlaubte Werte: `auto` (Standard) `1024x1024` `1536x1024` (Querformat) `1024x1536` (Hochformat)
quality (Optional)	Die Qualität des generierten Bildes. Erlaubte Werte: `auto` (Standard) `high` `medium` `low`
n (Optional)	Die Anzahl der zu generierenden Bilder. Muss zwischen 1 und 10 liegen. Standard ist 1.
background (Optional)	Ermöglicht das Setzen von Transparenz für den Hintergrund des generierten Bildes. Erlaubte Werte: `auto` (Standard) `transparent` `opaque` Hinweis: Bei `transparent` muss das Ausgabeformat Transparenz unterstützen (`png` oder `webp`). Dieser Parameter wird nur bei der Neugenerierung verwendet (nicht bei Edit mit `imageUuids`).
output_format (Optional)	Das Format der generierten Bilder. Erlaubte Werte: `png` (Standard) `jpeg` `webp` Hinweis: Wird nur bei der Neugenerierung verwendet. Bei der Bearbeitung (Edit) ist das Ergebnis immer `png`.
output_compression (Optional)	Die Komprimierungsstufe (0–100 %) für die generierten Bilder. Standard ist 100. Hinweis: Nur mit den Ausgabeformaten `webp` oder `jpeg` unterstützt. Wird nur bei der Neugenerierung verwendet.
moderation (Optional)	Steuert die Inhaltsmoderation für generierte Bilder. Erlaubte Werte: `auto` (Standard) `low` (weniger restriktive Filterung) Hinweis: Wird nur bei der Neugenerierung verwendet.
allowedBasePathIds (Optional)	Optionaler Sicherheitsparameter für schreibende KI-Tools: Liste/Definition erlaubter Basispfade (IDs), in denen Schreiboperationen ausgeführt werden dürfen. Wenn gesetzt, wird vor dem Schreiben geprüft, ob das Zielobjekt innerhalb dieser erlaubten Pfade liegt.

Tipps und Tricks

Tipp: Je präziser und ausführlicher der Prompt formuliert ist, desto besser und passender wird das generierte Bild. Für Bildbearbeitung (image-to-image) sollte das Ursprungsbild eine möglichst hohe Qualität haben. Mit dem Parameter n können mehrere Varianten gleichzeitig erzeugt werden, um die beste Auswahl zu treffen.

Text