Alt-Text Optimizer Pro

FAQ & Fehlerbehebung

Häufige Fragen und Lösungen zu Fehlermeldungen.

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?

In Deutsch, Englisch, Französisch, Spanisch, Italienisch und Niederländisch. Die Sprache wird automatisch aus dem Shop-Kontext bestimmt; als Fallback dient die in der Konfiguration gewählte Standard-Sprache.

Werden bestehende Alt-Texte überschrieben?

Wenn du für ein Bild einen neuen Text erzeugst, ersetzt er einen vorhandenen. Generierte Texte stehen im normalen Alt-Text-Feld und sind als „KI-generiert“ markiert, sodass du sie gesammelt wiederfindest. Du kannst sie jederzeit von Hand anpassen oder wieder entfernen.

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.

Welche Bildformate werden unterstützt?

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

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.

Du kommst nicht weiter? Wir helfen gern. Über unsere Kontaktseite erreichst du uns direkt – wir kennen das Plugin schließlich aus erster Hand.

War diese Seite hilfreich?