FAQ & Fehlerbehebung

Hier findest du Antworten auf die häufigsten Fragen – und konkrete Lösungen, falls einmal eine Fehlermeldung auftaucht.

Häufige Fragen

Brauche ich einen eigenen OpenAI-Account?

Ja. Das Plugin nutzt deinen eigenen OpenAI-Schlüssel. So werden die Kosten transparent über deinen Account abgerechnet und du behältst die Kontrolle. Den Schlüssel erstellst du kostenlos unter platform.openai.com – siehe OpenAI API-Key einrichten.

Was kostet die Generierung?

Die Plugin-Lizenz ist von den OpenAI-Kosten getrennt. Pro Bild fallen nur wenige Cent – oft Bruchteile davon – an OpenAI-Gebühren an. Mit GPT-4o mini und niedriger Auflösung bleibt das sehr günstig.

In welchen Sprachen funktioniert das Plugin?

Seit Version 1.3.0 in allen Sprachen, die dein Shop hat – auch Polnisch, Schwedisch oder Tschechisch. Du wählst deine Zielsprachen in der Konfiguration und bekommst pro Bild einen eigenen Alt-Text je Sprache. Lässt du die Zielsprachen leer, generiert das Plugin wie früher nur in der Shop-Standardsprache. Ausführlich: Mehrsprachige Alt-Texte.

Kostet jede zusätzliche Sprache das Doppelte?

Nein – im Standardmodus „Eine Anfrage pro Bild“ liefert die KI alle Sprachen in einer einzigen Antwort. Es kommen also nur ein paar Antwort-Tokens dazu, nicht eine ganze zusätzliche Anfrage. Erst im Modus „Eine Anfrage pro Bild und Sprache“ steigen die Kosten linear mit der Zahl der Sprachen.

Werden bestehende Alt-Texte überschrieben?

Standardmäßig nicht. Die Option „Vorhandene Alt-Texte überspringen“ ist aktiv und sorgt dafür, dass nur generiert wird, was fehlt – auch pro Sprache. Bewusst überschreiben kannst du über „Neu generieren“ im Reiter „KI-generiert“. Generierte Texte stehen im normalen Alt-Text-Feld und sind als „KI-generiert“ markiert, sodass du sie gesammelt wiederfindest, von Hand anpassen oder entfernen kannst.

Ich habe eine neue Shop-Sprache – wie ergänze ich nur die?

Neue Sprache zu den Zielsprachen hinzufügen, „Vorhandene Alt-Texte überspringen“ aktiv lassen und im Reiter „Sprache fehlt“ generieren. Die bestehenden Texte werden dabei weder angefasst noch bezahlt. Schritt für Schritt steht das unter Mehrsprachige Alt-Texte.

Muss ich Bilder einzeln verarbeiten?

Nein. Du kannst mehrere Bilder per Häkchen auswählen oder mit Alle generieren einen ganzen Reiter abarbeiten – bis zu 100 Bilder pro Durchgang. Für größere Mengen gibt es Im Hintergrund generieren und die nächtliche automatische Generierung, siehe Hintergrund- & geplante Läufe.

Welche Bildformate werden unterstützt?

JPG, PNG, GIF und WebP. Andere Dateien (z. B. PDF, Video oder SVG) werden übersprungen.

Was passiert beim Deinstallieren mit meinen Alt-Texten?

Sie bleiben erhalten – in allen Sprachen. Generierte Alt-Texte sind ganz normale Shop-Inhalte, deshalb entfernt sie auch die Option „Alle Daten entfernen“ nicht (die betrifft nur plugineigene Strukturen wie Verlaufstabellen und Custom-Field- Definitionen). Willst du sie loswerden, nutze vor der Deinstallation die Aktion „Alle KI-Alt-Texte entfernen“ im Modul – sie löscht genau die Sprachen, die das Plugin geschrieben hat, und lässt manuell gepflegte Texte in Ruhe.

Fehlerbehebung

Tritt bei einem Bild ein Fehler auf, steht in der Fortschrittsliste eine kurze Meldung. Hier die häufigsten – und was zu tun ist.

„API token is not configured“

Es ist kein OpenAI-Schlüssel hinterlegt. Trage ihn in der Konfiguration unter OpenAI API-Token ein. Nutzt du kanal-spezifische Einstellungen, achte auf den richtigen Verkaufskanal.

„No AI model selected“

Es ist kein Modell ausgewählt. Wähle in der Konfiguration ein Modell (Standard: GPT-4o mini) und speichere erneut.

„Invalid API token“

Der Schlüssel ist falsch oder abgelaufen. Prüfe, ob du ihn vollständig und ohne Leerzeichen kopiert hast. Im Zweifel bei OpenAI einen neuen Schlüssel erstellen und eintragen.

„OpenAI Rate Limit reached“

Du hast in kurzer Zeit sehr viele Anfragen gestellt, und OpenAI bremst vorübergehend. Warte einen Moment und starte erneut. Tipp: große Mengen in kleineren Stapeln verarbeiten.

„The media is not an image“

Die ausgewählte Datei ist kein Bild. Das Plugin verarbeitet nur Bilddateien (JPG, PNG, GIF, WebP).

„Image file could not be found“

Die Bilddatei wurde nicht gefunden. Prüfe, ob die Datei im public-Ordner existiert. Bei ausgelagertem Speicher (externer CDN/Cloud-Storage) muss das Bild über seine URL erreichbar sein.

„Generated alt text is too short“

Der erzeugte Text ist kürzer als deine Mindestlänge. Reduziere in der Konfiguration die Minimale Zeichenanzahl oder erhöhe die maximale Antwortlänge (Tokens), damit längere Texte entstehen.

Eine einzelne Sprache fehlt im Ergebnis

Im Modus „Eine Anfrage pro Bild“ kann es passieren, dass die KI eine Sprache in ihrer Antwort auslässt. Die anderen Sprachen werden trotzdem gespeichert, nur die fehlende wird als Fehler protokolliert. Zwei Wege helfen: den Lauf über „Fehlgeschlagene erneut“ wiederholen oder für dieses Bild auf den Modus „Eine Anfrage pro Bild und Sprache“ wechseln.

Der Hintergrund-Lauf startet nicht

Hintergrund- und geplante Läufe brauchen die Shopware-Hintergrunddienste: einen aktiven Message-Consumer (messenger:consume) und den Scheduled-Task-Worker. Läuft einer davon nicht, bleibt der Job einfach in der Queue liegen. Details unter Hintergrund- & geplante Läufe.

Ein Bild steht unter „Sprache fehlt“, obwohl es einen Alt-Text hat

Das ist so gewollt: Der Reiter listet Bilder, denen in mindestens einer Sprache der Text fehlt. Die Spalte „Sprachen“ zeigt dir mit roten und grünen Badges, welche Sprache genau gemeint ist. Übrigens zählt dabei nur der explizit gepflegte Text pro Sprache – die Sprachvererbung von Shopware wird bewusst nicht mitgerechnet, sonst könnten Kindsprachen nie eigene Alt-Texte bekommen.