Dépannage
Solutions aux erreurs et problèmes courants lors de l'utilisation de la CLI, du SDK et du tableau de bord i1n.
i1n : commande introuvable
Cette erreur signifie que l'outil en ligne de commande i1n n'est pas installé globalement ou qu'il n'est pas dans votre PATH. Exécutez la commande npm install -g i1n pour l'installer. Si vous utilisez un gestionnaire de versions (nvm, fnm), assurez-vous que le répertoire des binaires globaux est dans votre PATH.
Sur macOS/Linux, vous pouvez vérifier le chemin d'installation avec which i1n. Si vous utilisez bun, exécutez plutôt bun install -g i1n.
Clé API invalide ou erreur d'authentification
Cela se produit lorsque la clé API dans i1n.config.json est manquante, expirée ou invalide. Générez une nouvelle clé à partir des paramètres de votre organisation sur dashboard.i1n.ai et exécutez i1n init pour reconfigurer.
Assurez-vous d'utiliser la bonne clé d'API pour l'organisation qui possède le projet. Chaque organisation a ses propres clés — une clé d'une organisation ne peut pas accéder aux projets d'une autre.
La poussée i1n échoue ou ignore les clés
Si i1n push ne renvoie aucune clé ou ignore des fichiers, vérifiez que votre répertoire de locales et le format de fichier correspondent à la configuration dans i1n.config.json. Exécutez i1n init pour reconfigurer si nécessaire.
Les causes courantes incluent des modèles glob incorrects, des formats de fichiers incompatibles (par exemple, JSON plat alors que JSON imbriqué est configuré) ou des fichiers de traduction vides.
i1n pull génère des fichiers vides
Cela signifie généralement que le projet n'a pas de traductions sur le serveur. Exécutez d'abord i1n push pour télécharger vos clés sources, puis i1n pull pour télécharger les traductions.
Si vous avez envoyé des clés mais que la récupération renvoie des fichiers vides, vérifiez que les langues cibles ont été ajoutées à votre projet en utilisant i1n add-language ou via le tableau de bord.
Erreurs TypeScript après extraction i1n
Si votre IDE affiche des erreurs après un pull, assurez-vous que i1n.d.ts est inclus dans votre compilation TypeScript. Le CLI met à jour automatiquement tsconfig.json, mais les configurations manuelles peuvent nécessiter des ajustements.
Ne modifiez jamais i1n.d.ts directement — il est régénéré à chaque extraction i1n. Si le fichier semble corrompu, supprimez-le et exécutez à nouveau i1n pull.
Associé
Référence CLI
Référence complète pour toutes les commandes, tous les drapeaux et toutes les options de l'interface de ligne de commande i1n.
Génération de types
Définitions TypeScript générées automatiquement pour des clés de traduction type-safe avec autocomplétion complète de l'IDE.
Tarifs et limites
Plans tarifaires i1n, crédits de traduction IA et limites d'utilisation.