Dépannage

Cabina ne casse jamais votre boutique : quand il ne peut pas fonctionner, il s’efface. C’est voulu, et c’est aussi pourquoi certaines de ces pannes sont totalement muettes.

Aucun bouton nulle part sur la fiche produit

Dans la console : une erreur CORS de votre navigateur, qui nomme www.cabina.io

Le domaine de votre boutique n’est pas dans la liste autorisée : l’API répond sans en-têtes CORS et le navigateur jette la réponse.

Ajoutez l’origine exacte dans Widget . https://boutique.fr et https://www.boutique.fr sont deux origines différentes : ajoutez les deux si les deux servent la boutique.

La même liste vaut pour les essayages : un essayage demandé depuis un site absent de la liste est refusé (403) avant de consommer le moindre crédit. Si les essayages se sont arrêtés après un changement de domaine, le remède est le même : ajoutez le nouveau domaine.

Pas de bouton, et pas d’erreur CORS non plus

Dans la console : [widget] error=WIDGET_CONFIG_MISSING

La clé API est absente, ou elle n’a pas été lue depuis la balise.

Vérifiez que data-api-key se trouve sur la balise <script> elle-même et commence par cab_live_.

Pas de bouton, et rien du tout dans la console

Dans la console : rien — celle-ci est muette

Votre forfait a épuisé ses sessions, ou vos crédits sont terminés. Le widget se cache volontairement, pour que votre boutique continue de fonctionner.

Vérifiez Facturation .

Le bouton se trouve tout en bas de la page

Dans la console : rien — muette également

Aucun des points d’ancrage connus ne correspondait à votre thème : le bouton a été ajouté à <body>.

Ajoutez <div data-cabina-target></div> là où vous le voulez : le bouton se place à l’intérieur de cet élément. Voir Déplacer le bouton.

Deux boutons, et les sessions comptées en double

Dans la console : [widget] warn=GIA_CARICATO

Le snippet est deux fois sur la page — souvent une ancienne copie plus une extension.

Retirez l’une des deux balises <script>.

Le bouton s’ouvre, mais l’essayage échoue en cours de route

Dans la console : rien

Cabina n’a pas réussi à trouver l’image du vêtement sur la page.

Ajoutez une balise og:image à votre gabarit produit — voir L’image du vêtement.

Certains essayages échouent quand beaucoup de clients essaient en même temps

Dans la console : rien ; dans l’onglet Réseau du navigateur, une réponse 429

Cabina accepte au maximum 30 essayages par minute et par boutique : personne ne peut ainsi vider vos crédits en quelques minutes avec la clé publique. Au-delà de ce seuil, l’essayage échoue : il suffit de réessayer un peu plus tard.

L’essayage démarre, puis échoue avec « L’essayage a échoué »

Dans la console : rien

Le widget a trouvé le vêtement et la photo du client, mais la génération n’est pas allée au bout. Un essayage échoué ne consomme pas de crédits. Les raisons, de la plus courante à la plus rare :

• La photo du vêtement n’est pas exploitable. Un collage, un gros plan, un vêtement vu de dos ou avec du texte par-dessus ne suffisent pas au moteur. La bonne photo est décrite dans Les photos.
• La photo du client. En pied, debout, bien éclairée : c’est un conseil, pas une obligation, mais une personne coupée en deux ou plusieurs personnes sur la même photo font échouer la génération.
• Le moteur est momentanément arrêté. C’est rare ; l’état en temps réel est sur cabina.io/status . Il suffit de réessayer quelques minutes plus tard.

Si ce sont les essayages du mois qui sont épuisés, le bouton disparaît des pages produit jusqu’au renouvellement du forfait ou à l’achat d’essayages supplémentaires depuis Forfait .

Lingerie, maillots de bain et vêtements transparents

Dans la console : rien

Les modèles d’IA que Cabina utilise pour reconnaître le vêtement et générer l’essayage appartiennent à des fournisseurs externes, qui appliquent des règles de contenu qui ne dépendent pas de nous. La lingerie, les maillots de bain et les tissus transparents peuvent être refusés par ces règles : la reconnaissance du vêtement peut échouer, et l’essayage peut ne pas démarrer ou s’arrêter en cours de route.

Nous avons testé la lingerie (octobre 2026 : ensembles en dentelle et en résille, bodys transparents, porte-jarretelles, pyjamas et chemises de nuit, sur quatre morphologies) : l’essayage a fonctionné pour chaque vêtement. La reconnaissance du vêtement n’a refusé qu’une photo, où le vêtement était porté par un mannequin ; dans ce cas, l’essayage démarre quand même. Pour la lingerie, une photo du vêtement seul compte encore plus.

Nous n’avons pas encore testé les maillots de bain ni les vêtements transparents qui ne sont pas de la lingerie (chemisiers, robes) : si vous en vendez, écrivez-nous avec le lien d’un produit avant d’activer Cabina, nous le testerons ensemble.

Le bouton fonctionne, mais aucune taille n’est suggérée

Dans la console : rien

Le client n’a pas donné les mesures dont ce vêtement a besoin — par exemple seulement sa stature pour un haut, qui demande la poitrine et le tour de taille. Le widget préfère n’afficher aucune taille plutôt que d’en deviner une.

Les mesures nécessaires pour chaque type de vêtement sont dans Le tableau de bord.

Vérifier depuis un terminal

# 1. la balise est bien servie
curl -s https://votre-boutique.com/produits/un-produit | grep -o 'widget.iife.js'
 
# 2. la page expose une image du vêtement
curl -s https://votre-boutique.com/produits/un-produit | grep -o 'og:image[^>]*'

Ce sont les deux qui échouent. Si les deux répondent, le problème est presque toujours le domaine non autorisé.

Aucun de ces cas ?

Écrivez à info@cabina.io avec le lien d’une fiche produit et, si possible, ce que vous voyez dans la console.