Ein paar Dutzend Bilder erledigst du bequem direkt im Browser. Bei ein paar tausend willst du den Rechner aber nicht stundenlang offen lassen – dafür gibt es Hintergrund-Läufe über die Shopware-Message-Queue und die nächtliche automatische Generierung.

Browser-Lauf oder Hintergrund-Lauf?

	Browser-Lauf („Alle generieren“)	Hintergrund-Lauf („Im Hintergrund generieren“)
Wo läuft es?	Im geöffneten Admin-Tab	In der Message-Queue deines Shops
Tab schließen?	Nein – der Lauf hängt am Tab	Ja, jederzeit
Fortschritt	Live auf der Generierungsseite	Im Verlauf nachvollziehbar
Gut für	Einzelbilder, kleine Stapel, schnelles Ausprobieren	Große Mediatheken, komplette Sprach-Nachrüstungen

Beide Wege nutzen dieselbe Konfiguration und dieselbe Sprachauswahl – es geht nur darum, wo die Arbeit stattfindet.

Voraussetzungen

Damit Hintergrund- und geplante Läufe überhaupt anlaufen, muss dein Shop die üblichen Shopware-Hintergrunddienste betreiben:

ein aktiver Message-Consumer (bin/console messenger:consume),
und der Scheduled-Task-Worker für die nächtliche Generierung.

Bei den meisten gehosteten Shopware-Installationen läuft beides ohnehin (oft als Systemd-Service oder Cronjob). Startet ein Hintergrund-Lauf nicht, liegt es fast immer daran – frag im Zweifel deinen Hoster oder deine Agentur.

Im Hintergrund generieren

Der Ablauf ist derselbe wie bei einem normalen Lauf: Bilder auswählen (oder alle nehmen), Sprachen prüfen – und statt „Alle generieren“ auf „Im Hintergrund generieren“ klicken. Danach kannst du den Tab schließen; die Bilder werden Stück für Stück abgearbeitet.

Die Sprachen werden beim Start eingefroren. Ein laufender Job zieht genau die Sprachauswahl durch, mit der du ihn gestartet hast. Änderst du danach die Zielsprachen in den Einstellungen, betrifft das erst den nächsten Lauf – laufende Jobs ändern ihr Verhalten nicht mitten drin.

Verlauf: Läufe nachvollziehen

Über den Button „Verlauf“ im Modul kommst du zur Liste aller bisherigen Läufe. Dort siehst du je Lauf unter anderem, welche Sprachen er verarbeitet hat.

In den Durchlauf-Details steht das Protokoll je Bild und Sprache mit einem von vier Ergebnissen:

generiert – die KI hat einen neuen Text geliefert.
übernommen – der Text stammt aus der Elternsprache (siehe Kindsprachen), ohne API-Kosten.
bereits vorhanden – in dieser Sprache gab es schon einen Text, er wurde übersprungen.
Fehler – mit der konkreten Meldung. Die häufigsten stehen in der Fehlerbehebung.

Damit lässt sich hinterher genau beantworten, was ein Lauf gekostet und bewirkt hat – und warum ein bestimmtes Bild in einer bestimmten Sprache noch leer ist.

Fehlgeschlagene erneut

Ist ein Lauf mit Fehlern durchgelaufen, findest du in den Durchlauf-Details den Button „Fehlgeschlagene erneut“. Er startet einen Folgelauf im Modus „Wiederholung“ über genau die fehlgeschlagenen Bilder – mit derselben Sprachauswahl wie der ursprüngliche Lauf.

Was dabei passiert, hängt an der Option „Vorhandene Alt-Texte überspringen“:

aktiv (Standard): Es werden nur die noch fehlenden Sprachen generiert.
deaktiviert: Alle Sprachen der betroffenen Bilder werden neu erzeugt.

Das ist der entspannteste Weg, nach einem Rate-Limit oder einer kurzen Störung bei OpenAI die Lücken zu schließen – ohne den kompletten Lauf zu wiederholen.

Nächtliche automatische Generierung

Der geplante Lauf hält deine Mediathek im Alltag automatisch sauber: Er nimmt die konfigurierten Zielsprachen und ergänzt in den gewählten Ordnern alle Bilder, denen in mindestens einer Zielsprache der Alt-Text fehlt.

Praktisch heißt das: Lädst du tagsüber neue Produktbilder hoch, haben sie am nächsten Morgen ihre Alt-Texte – in allen Sprachen, ohne dass du daran denken musst.

Auch der nächtliche Lauf verursacht echte API-Kosten bei OpenAI. Schränke die Ordner bewusst auf die Bereiche ein, in denen tatsächlich neue Bilder landen (typischerweise die Produktbilder), statt die gesamte Mediathek freizugeben.

Schnellaktion direkt in der Mediathek

Für den Zwischendurch-Fall brauchst du das Modul gar nicht: In der Medien-Seitenleiste gibt es die Schnellaktion „KI-Alt-Text generieren“. Sie erzeugt den Text für das ausgewählte Bild in allen konfigurierten Zielsprachen.

Hat das Bild bereits Alt-Texte, fragt ein Bestätigungsdialog nach, bevor überschrieben wird – versehentlich verlierst du hier also nichts.

Bleiben noch die häufigen Fragen und Fehlermeldungen: FAQ & Fehlerbehebung.