OpenaiImageService

Der OpenaiImageService ermöglicht dir die Bildgenerierung über OpenAI DALL-E sowie die Bildanalyse über GPT Vision. Du kannst damit Bilder erzeugen, URLs abrufen und vorhandene Bilder analysieren lassen.

Zugriff

const imageService = RAGAI.AIIMAGE_OPENAI;

---

Methoden

create(prompt, opts?)

Generiert ein Bild über OpenAI DALL-E anhand eines Text-Prompts.

Parameter:

Parameter	Typ	Pflicht	Beschreibung
prompt	string	Ja	Beschreibung des zu generierenden Bildes
opts	object	Nein	Optionale Konfiguration
opts.size	string	Nein	Bildgröße, z. B. "1024x1024", "1792x1024", "1024x1792"
opts.quality	string	Nein	Bildqualität, z. B. "standard" oder "hd"
opts.style	string	Nein	Bildstil, z. B. "vivid" oder "natural"

Rückgabe: Promise<AiImageFile> – Ein Objekt mit den Bilddaten inkl. Datei-ID.

// Einfache Bildgenerierung
const image = await RAGAI.AIIMAGE_OPENAI.create("Ein Sonnenuntergang über dem Meer");

// Mit Optionen
const image = await RAGAI.AIIMAGE_OPENAI.create("Ein Roboter in einer Bibliothek", {
  size: "1024x1024",
  quality: "hd",
  style: "vivid"
});

---

getImageUrl(fileId)

Gibt die URL eines zuvor generierten Bildes zurück.

Parameter:

Parameter	Typ	Pflicht	Beschreibung
fileId	string	Ja	Die Datei-ID des generierten Bildes

Rückgabe: string – Die URL zum Bild.

const image = await RAGAI.AIIMAGE_OPENAI.create("Ein Berg bei Nacht");
const url = RAGAI.AIIMAGE_OPENAI.getImageUrl(image.fileId);

// URL z. B. in einer Nachricht verwenden
RAGAI.CARDS.image(url);

---

analyzeImage(image, prompt)

Analysiert ein Bild mithilfe von GPT Vision. Du kannst sowohl eine Bild-URL als auch ein Base64-kodiertes Bild übergeben.

Parameter:

Parameter	Typ	Pflicht	Beschreibung
image	string	Ja	Bild-URL oder Base64-kodierter Bildstring
prompt	string	Ja	Anweisung für die Bildanalyse

Rückgabe: Promise<string> – Die Analyseantwort als Text.

// Bild per URL analysieren
const beschreibung = await RAGAI.AIIMAGE_OPENAI.analyzeImage(
  "https://example.com/foto.jpg",
  "Beschreibe, was auf diesem Bild zu sehen ist."
);

// Base64-Bild analysieren
const analyse = await RAGAI.AIIMAGE_OPENAI.analyzeImage(
  "data:image/png;base64,iVBORw0KGgo...",
  "Welche Farben dominieren in diesem Bild?"
);

---

Vollständiges Beispiel

async function bildWorkflow() {
  // 1. Bild generieren
  const image = await RAGAI.AIIMAGE_OPENAI.create("Eine futuristische Stadt bei Nacht", {
    size: "1024x1024",
    quality: "hd",
    style: "vivid"
  });

  // 2. URL abrufen
  const url = RAGAI.AIIMAGE_OPENAI.getImageUrl(image.fileId);

  // 3. Generiertes Bild analysieren
  const analyse = await RAGAI.AIIMAGE_OPENAI.analyzeImage(
    url,
    "Beschreibe die Architektur in diesem Bild."
  );

  // 4. Ergebnis ausgeben
  RAGAI.CARDS.image(url);
  RAGAI.MSG.botMessage(analyse);
}