.AIIMAGE_OPENAI

Erzeugt und analysiert Bilder per OpenAI (RAGAI.AIIMAGE_OPENAI).

Hintergrund

create generiert per Standard ein neues Bild; über opts.image/opts.images wird stattdessen eine Bildbearbeitung (Referenzbild(er) als Basis) angestoßen. analyzeImage ist die einzige der drei Bild-Provider-Klassen (AIIMAGE_OPENAI/_FALAI/_STABLEDIFFUSION), die auch Bild-Analyse (Vision, nicht nur Generierung) anbietet - die anderen beiden können nur erzeugen/bearbeiten.

Methoden

.create(prompt, opts?)

Generiert ein Bild per OpenAI-Modell.

Parameter	Typ	Beschreibung
prompt	string | z.input<typeof aiImageCreateSchema>	Der Text-Prompt oder ein Objekt gemäß aiImageCreateSchema.
opts	Omit<ImageGenerateParams, "prompt"> & &#123; image?: string, images?: string[], aspectRatio?: string &#125;	Zusätzliche OpenAI-Bildoptionen.

Objekt-Form (validiert über aiImageCreateSchema):

Feld	Typ	Pflicht	Beschreibung
prompt	string	✔	Der Text-Prompt für die Bildgenerierung.
image	string	–	Referenzbild-URL für die Bildbearbeitung.
images	array	–	Mehrere Referenzbilder für die Bildbearbeitung.
aspectRatio	string	–	Gewünschtes Seitenverhältnis des Ergebnisbildes.
quality	string	–	Gewünschte Bildqualität.
model	string	–	Das zu verwendende Bildmodell.

Rückgabewert: Promise<AiImageFile>

Die erzeugte Bilddatei.

.getImageUrl(fileId)

Erstellt eine ladbare URL für ein zuvor erzeugtes Bild.

Parameter	Typ	Beschreibung
fileId	string | z.input<typeof aiImageFileIdSchema>	ID der Bilddatei oder ein Objekt gemäß aiImageFileIdSchema.

Objekt-Form (validiert über aiImageFileIdSchema):

Feld	Typ	Pflicht	Beschreibung
fileId	string	✔	ID der Bilddatei.

Rückgabewert: string

Die URL zum Laden des Bildes.

.analyzeImage(image, prompt?)

Lässt ein Bild von OpenAI analysieren und beschreiben.

Parameter	Typ	Beschreibung
image	string | z.input<typeof aiImageAnalyzeSchema>	Bild-URL oder ein Objekt gemäß aiImageAnalyzeSchema.
prompt	string	Zusätzliche Anweisung für die Analyse.

Objekt-Form (validiert über aiImageAnalyzeSchema):

Feld	Typ	Pflicht	Beschreibung
image	string	✔	Bild-URL, das analysiert werden soll.
prompt	string	✔	Zusätzliche Anweisung für die Analyse.

Rückgabewert: Promise<string>

Die von der KI erzeugte Bildbeschreibung.