Fehlerbehebung

Cabina macht deinen Shop nie kaputt: wenn es nicht arbeiten kann, nimmt es sich raus. Das ist Absicht — und auch der Grund, warum einige dieser Störungen völlig lautlos sind.

Nirgends auf der Produktseite ein Button

In der Konsole: ein CORS-Fehler deines Browsers, der www.cabina.io nennt

Die Domain deines Shops steht nicht auf der Freigabeliste, also antwortet die API ohne CORS-Header und der Browser verwirft die Antwort.

Trag die exakte Origin unter Widget  ein. https://shop.de und https://www.shop.de sind zwei verschiedene Origins: trag beide ein, wenn beide den Shop ausliefern.

Dieselbe Liste gilt für Anproben: Eine Anprobe, die von einer Seite außerhalb der Liste angefordert wird, wird abgelehnt (403), bevor Credits verbraucht werden. Haben die Anproben nach einem Domainwechsel aufgehört, hilft dasselbe: Trag die neue Domain ein.

Kein Button, und auch kein CORS-Fehler

In der Konsole: [widget] error=WIDGET_CONFIG_MISSING

Der API-Schlüssel fehlt, oder er wurde nicht vom Tag gelesen.

Prüf, dass data-api-key am <script>-Tag selbst steht und mit cab_live_ beginnt.

Kein Button, und in der Konsole überhaupt nichts

In der Konsole: nichts — dieser Fall ist stumm

Dein Tarif hat die Sitzungen aufgebraucht, oder die Credits sind alle. Das Widget versteckt sich absichtlich, damit dein Shop weiterläuft.

Schau unter Abrechnung .

Der Button sitzt ganz unten auf der Seite

In der Konsole: nichts — auch dieser Fall ist stumm

Keiner der bekannten Ankerpunkte passte auf dein Theme, also wurde der Button an <body> gehängt.

Setz <div data-cabina-target></div> dorthin, wo du ihn haben willst: der Button kommt in dieses Element. Siehe Den Button verschieben.

Zwei Buttons, und Sitzungen doppelt gezählt

In der Konsole: [widget] warn=GIA_CARICATO

Das Snippet steht zweimal auf der Seite — oft eine alte Kopie plus ein Plugin.

Entferne eines der beiden <script>-Tags.

Der Button öffnet, aber die Anprobe scheitert mittendrin

In der Konsole: nichts

Cabina hat das Bild des Kleidungsstücks auf der Seite nicht gefunden.

Ergänze ein og:image-Meta-Tag in deiner Produktvorlage — siehe Das Bild des Kleidungsstücks.

Manche Anproben scheitern, wenn viele gleichzeitig anprobieren

In der Konsole: nichts; im Netzwerk-Tab des Browsers eine 429-Antwort

Cabina nimmt höchstens 30 Anproben pro Minute und Shop an, damit niemand mit dem öffentlichen Schlüssel deine Credits in wenigen Minuten leeren kann. Über dieser Schwelle scheitert die Anprobe: Es reicht, es kurz darauf erneut zu versuchen.

Die Anprobe startet, scheitert dann aber mit „Anprobe fehlgeschlagen“

In der Konsole: nichts

Das Widget hat das Kleidungsstück und das Kundenfoto gefunden, aber die Generierung ist nicht zu Ende gekommen. Eine gescheiterte Anprobe verbraucht keine Credits. Die Gründe, vom häufigsten zum seltensten:

• Das Produktfoto ist nicht brauchbar. Eine Collage, ein Detail, ein Kleidungsstück von hinten oder mit Text darüber reichen dem Modell nicht. Das richtige Foto ist in Die Fotos beschrieben.
• Das Kundenfoto. Ganze Figur, stehend, gut beleuchtet: ein Rat, keine Pflicht, aber eine halb abgeschnittene Person oder mehrere Personen auf demselben Foto lassen die Generierung scheitern.
• Das Modell ist vorübergehend nicht erreichbar. Das kommt selten vor; der Live-Status steht auf cabina.io/status . Ein paar Minuten später noch einmal versuchen genügt.

Sind dagegen die Anproben des Monats aufgebraucht, verschwindet der Button von den Produktseiten, bis der Tarif sich erneuert oder du unter Tarif  zusätzliche Anproben kaufst.

Wäsche, Bademode und transparente Kleidung

In der Konsole: nichts

Die KI-Modelle, mit denen Cabina das Kleidungsstück erkennt und die Anprobe erzeugt, stammen von externen Anbietern und wenden Inhaltsregeln an, die nicht von uns abhängen. Wäsche, Bademode und durchsichtige Stoffe können von diesen Regeln abgelehnt werden: Die Erkennung des Kleidungsstücks kann scheitern, und die Anprobe startet womöglich nicht oder bricht mittendrin ab.

Wäsche haben wir getestet (Oktober 2026: Spitzen- und Netz-Sets, transparente Bodys, Strapsgürtel, Pyjamas und Nachthemden, an vier Körpertypen): Die Anprobe hat bei jedem Kleidungsstück geklappt. Die Erkennung hat nur ein Foto abgelehnt, auf dem das Kleidungsstück von einem Model getragen wurde; dann startet die Anprobe trotzdem. Bei Wäsche zählt ein Foto des Kleidungsstücks allein noch mehr.

Bademode und durchsichtige Kleidung, die keine Wäsche ist (Blusen, Kleider), haben wir noch nicht getestet: Wenn du sie verkaufst, schreib uns vor dem Aktivieren von Cabina mit dem Link zu einem Produkt, und wir testen es gemeinsam.

Der Button funktioniert, schlägt aber keine Größe vor

In der Konsole: nichts

Die Kundin oder der Kunde hat die Maße, die dieses Kleidungsstück braucht, nicht angegeben — zum Beispiel nur die Körpergröße bei einem Oberteil, das Brust und Taille braucht. Das Widget zeigt lieber keine Größe an, als eine zu raten.

Welche Maße jede Art von Kleidungsstück braucht, steht unter Das Dashboard.

Vom Terminal aus prüfen

# 1. das Tag wird wirklich ausgeliefert
curl -s https://dein-shop.de/produkte/ein-produkt | grep -o 'widget.iife.js'
 
# 2. die Seite gibt ein Bild des Kleidungsstücks aus
curl -s https://dein-shop.de/produkte/ein-produkt | grep -o 'og:image[^>]*'

Diese beiden sind es, die scheitern. Wenn beide antworten, ist es fast immer die nicht freigegebene Domain.

Keiner dieser Fälle?

Schreib an info@cabina.io mit dem Link zu einer Produktseite und, wenn möglich, dem, was du in der Konsole siehst.