Dépannage
Résolvez les problèmes courants d'importation, de mappage, de crédits, de progression, de téléchargement et d'accès développeur d'AI Glot sans perdre votre travail.
Ouvrez le symptôme correspondant à votre situation. Les solutions ci-dessous ne suppriment pas de traduction et ne consomment pas de crédits supplémentaires.
Le CSV est rejeté avant l'importation
Réexportez-le au format CSV UTF-8 et vérifiez l’absence d’en-têtes vides ou en double, de guillemets non fermés et de lignes ayant un nombre de colonnes différent. Les plafonds d’importation varient selon le format : 60 Mo pour CSV, 4 Mo pour un fichier locale. Voir Fichiers et formats.
Une cellule est trop longue pour être traduite
Chaque cellule source individuelle sélectionnée pour la traduction peut contenir jusqu’à 50 000 caractères Unicode. Divisez les contenus HTML ou éditoriaux plus longs en plusieurs lignes ou champs plus petits, puis importez le CSV révisé. Cette limite s’applique à une seule cellule et est distincte de la limite plus courte utilisée pour grouper les cellules ordinaires en tâches de traduction.
L'analyse a choisi les mauvaises colonnes ou langues
L’analyse est une proposition. Modifiez la disposition, la source, la destination, le mode de langue ou les langues cibles sur l’écran de révision avant de commencer. Prévisualisez les valeurs d’échantillon pour distinguer les colonnes de contenu des identifiants ou des métadonnées.
L'estimation des crédits semble trop élevée
Vérifiez quelles cellules sont incluses dans la disposition sélectionnée. Les colonnes multilingues multiplient le nombre de sources par le nombre de destinations ; le mode Full CSV inclut chaque cellule de texte traduit. Les plans payants peuvent utiliser Lite pour les contenus groupés éligibles, pour environ un tiers du coût Standard.
La traduction semble lente
Laissez la page du lot ouverte pour voir la phase et le pourcentage en temps réel, mais la tâche continue même si vous partez. Plusieurs langues de destination, de nombreuses cellules courtes et des tentatives de reconnexion peuvent prendre plus de temps qu’un fichier de taille similaire avec une seule destination. AI Glot vous envoie un e-mail à la fin.
Si la progression n’a pas changé pendant une période prolongée, rechargez la page une fois. Le serveur, et non l’animation du navigateur, fait foi. Un échec terminal restitue automatiquement les crédits réservés et affiche un message d’erreur sécurisé.
Le fichier téléchargé ne s'importe pas
Comparez-le à l’exportation originale : même délimiteur, mêmes en-têtes, même nombre de colonnes et mêmes identifiants de ligne. AI Glot les préserve, mais le système de destination peut imposer ses propres champs obligatoires, longueurs de valeurs ou codes locale.
L'authentification API, CLI ou MCP échoue
Vérifiez que l’identifiant est actif, appartient à l’espace de travail attendu et possède la portée requise. Pour les problèmes de CLI, lancez aiglot doctor. Pour les échecs d’API structurés, suivez l’URL docs_url et citez l’identifiant request_id retourné lors du contact avec le support.
Un outil ne lance pas la traduction
Vérifiez la portée, pas l’outil : l’API REST, les outils MCP et la CLI peuvent tous en lancer une. La création et l’approbation nécessitent toutes deux batches:create, et cette portée est exclue du plafond membre par défaut : un administrateur doit l’élargir avant qu’une connexion membre puisse dépenser des crédits. Une approbation sans planification préalable échoue avec l’erreur no_plan_yet.
Contacter le support
Si les étapes ci-dessus ne résolvent pas le problème, ouvrez Support dans l’application. Indiquez le nom de l’espace de travail, l’ID du lot et l’ID de la requête le cas échéant, mais n’incluez jamais de clé API ou de jeton d’accès.
