FAQ

Beide liefern sehr gute Ergebnisse. Grobe Daumenregel:

• Anthropic (Claude Sonnet 4) — Standard, besonders stark bei Design- und Stil-Feldern, hält sich zuverlässig an das JSON-Schema und die Farbpalette.
• OpenAI (GPT-4o) — etwas günstiger im gpt-4o-mini-Modus, weit verbreitet, gute Ergebnisse bei Alltagsgegenständen.

Der API-Key wird im Admin unter Erweiterungen > DasBild > Konfigurieren eingetragen, der Button API Key testen prüft sofort, ob alles passt.

Die Kosten hängen vom gewählten Modell ab. Pro Produkt wird genau ein Vision-API-Call abgesetzt — mit Bild bis 1024 px Kantenlänge und max. 2048 Output-Tokens. Typische Größenordnung mit den Default-Modellen:

• Claude Sonnet 4: ca. 1–3 Cent pro Bild
• GPT-4o: ca. 1–2 Cent pro Bild
• GPT-4o-mini: ca. 0,1–0,3 Cent pro Bild (deutlich günstiger, etwas schwächer)

Aktuelle Preise bei den Anbietern prüfen. Ein --dry-run zählt vorab, wie viele Produkte analysiert würden.

Der Test-Button gibt klare Fehlermeldungen aus:

• API-Key ungültig — Key bei console.anthropic.com bzw. platform.openai.com prüfen. Achte auf Leerzeichen beim Einfügen.
• Kein Guthaben / Rate-Limit — Zahlungsmittel hinterlegen, Guthaben aufladen.
• Modell nicht gefunden — Feld Modell leer lassen (nutzt Default) oder korrekte ID eintragen.
• Verbindungsfehler — Server-Firewall prüfen; ausgehende HTTPS-Requests an api.anthropic.com bzw. api.openai.com müssen erlaubt sein.

Mögliche Ursachen:

• Kein Cover-Bild: Das Produkt braucht ein Cover-Bild (oder das Hauptprodukt bei Varianten).
• Feld nicht aktiviert: Unter Aktive KI-Felder ist das Feld eventuell abgewählt.
• Confidence „unsicher“: Die KI meldet leere Werte mit confidence: unsicher, wenn sie nichts Eindeutiges erkennt. Im Admin-Review sichtbar.
• ext-gd fehlt: Ohne GD wird das Bild nicht skaliert — prüfen mit php -m | grep gd.
• Bild zu klein / unscharf: Bilder unter ~300 px Kantenlänge liefern deutlich schlechtere Ergebnisse.

Das Plugin erkennt alte Gruppen aus früheren Versionen („Bildfarben“, „Image Colors“) und nutzt sie weiter statt eine zweite anzulegen. Falls trotzdem Duplikate existieren (z.B. aus manueller Pflege):

bin/console sven:das-bild:reset
bin/console sven:das-bild:ki-analyze --force

Der Reset räumt alle vom Plugin angelegten Gruppen auf, die anschließende Analyse legt sauber eine einzige Gruppe an.

Ja. Unter Eigene KI-Felder (fortgeschritten) definieren Sie eigene Felder — eine Zeile pro Feld, Pipe-getrennt. Details und Beispiele siehe KI-Bildanalyse → Eigene KI-Felder.

Nach dem Anpassen einmal sven:das-bild:reset laufen lassen und dann --force analysieren — sonst bleiben die alten Property-Gruppen bestehen.

Der Prompt weist die KI explizit an, das Produkt und nicht das Bild zu beschreiben. Das funktioniert zuverlässig, aber nicht zu 100 Prozent. Falls eine Beschreibung trotzdem so beginnt:

• Das betroffene Produkt erneut analysieren (-p PRODNUMMER --force)
• Im Admin das Feld manuell bearbeiten — die manuelle Änderung wird in ki_result_json mit confidence: "manuell" markiert und bleibt bei Reruns bestehen
• Kurze Beschreibungslänge (short) reduziert die Fehlerquote zusätzlich

Nur wenn die jeweilige Checkbox in der Konfiguration aktiv ist — Meta-Titel automatisch setzen bzw. Meta-Beschreibung automatisch setzen. Standard ist in beiden Fällen aus, damit eigene SEO-Pflege nicht versehentlich überschrieben wird.

Die KI-Werte bleiben auch bei deaktivierten Schaltern im Custom Field ki_result_json und können im Admin per Knopfdruck selektiv übernommen werden.

Ja. Fehlt einer Variante das eigene Cover-Bild, zieht das Plugin das Cover des Hauptprodukts. Dasselbe gilt für den Produktkontext: fehlt der Name oder Hersteller, wird er aus dem Parent geladen. Die Analyse-Ergebnisse werden dann an der Variante gespeichert — jede Variante bekommt ihre eigenen Properties.

• JPEG / JPG
• PNG
• WebP
• GIF

Vor dem API-Call wird das Bild bei Bedarf auf max. 1024 px Kantenlänge skaliert (JPEG, Qualität 85). Die Originaldatei im Shop bleibt unverändert.

Wenn ki-analyze -p SW10001 meldet, das Produkt sei nicht gefunden:

• Produktnummer exakt? Groß-/Kleinschreibung und Leerzeichen beachten.
• Aktiv? Die Batch-Analyse filtert active = true. Einzelanalyse per -p funktioniert aber auch bei inaktiven Produkten.
• UUID versuchen: Statt Produktnummer die UUID aus der URL im Admin nehmen.

Beide API-Routes stehen im Admin zur Verfügung:

• ki-preview — ruft die KI auf und zeigt das Ergebnis an, ohne etwas in die Datenbank zu schreiben. Für Review und Feintuning vor dem Speichern.
• ki-analyze-product — ruft die KI auf und speichert alle Felder (Properties, Custom Fields, optional Meta-Titel/-Beschreibung).

Auf der CLI entspricht das --dry-run (Preview) gegenüber einem normalen Lauf (Analyze).