Dépannage

L'application ne s'installe pas ou ne s'ouvre pas

Windows

Si SmartScreen bloque le programme d'installation, choisissez Plus d'informations → Exécuter quand même. La version de bureau est signée par code, donc cela n'apparaît normalement pas.

macOS

Si macOS refuse d'ouvrir l'application, ouvrez Paramètres système → Confidentialité et sécurité et autorisez-la ici, puis relancez-la.

Vérifiez que vous avez glissé 9xChat dans Applications, au lieu de l’exécuter depuis l’image disque montée.

Linux

Vérifiez que le fichier téléchargé est marqué comme exécutable. Si ce n'est pas le cas, définissez le bit exécutable dessus et exécutez-le à nouveau.

Mobile

Installez via Google Play ou App Store pour que les mises à jour arrivent automatiquement. Si l'application ne démarre pas, mettez-la à jour, puis redémarrez votre appareil.

Les réponses échouent ou s’arrêtent à mi-chemin

Parcourez-les dans l’ordre :

1. Vérifiez votre connexion. Les modèles cloud nécessitent un accès à Internet. Les modèles locaux le font pas. Si les requêtes cloud échouent mais que les requêtes locales fonctionnent, le problème vient du réseau ou du fournisseur, pas de 9xchat.

2. Vérifiez votre solde créditeur. Si vous utilisez des crédits 9xchat et qu'ils ont s'épuiser, les demandes s'arrêtent. Rechargez ou passez à votre propre clé API.

3. Vérifiez votre clé API. Si vous avez apporté votre propre clé, confirmez qu'elle est toujours valide et il reste un quota chez ce fournisseur.

4. Essayez un autre modèle. Si un modèle échoue et qu'un autre réussit, le problème est avec ce modèle ou ce fournisseur spécifique.

Un modèle est manquant ou ne se chargera pas

• Les modèles cloud nécessitent des crédits ou une clé API configurée pour cela. fournisseur. Dans Bibliothèque → Modèles, un fournisseur reste marqué Inactif tant que vous n’avez pas ajouté sa clé. Ce libellé permet de voir rapidement quels fournisseurs sont inaccessibles.

• Les modèles locaux nécessitent le démarrage de votre moteur local pour que 9xChat puisse s’y connecter. Démarrez-le d’abord, puis rouvrez la liste des modèles.

Votre clé API est rejetée

La panne est chez le fournisseur, donc le correctif est là aussi :

1. Collez à nouveau la clé, sans espaces de début ou de fin.
2. Confirmez que la clé appartient au fournisseur sous lequel vous l'avez ajoutée.
3. Vérifiez que la clé existe toujours et qu’elle n’a pas été révoquée ou pivotée.
4. Vérifiez que la facturation est configurée et que le quota restant auprès de ce fournisseur est un une clé valide sans solde échoue de la même manière qu’une mauvaise.
5. Confirmez que le modèle que vous avez choisi est celui que votre compte est autorisé à utiliser. Certains les modèles nécessitent un niveau distinct avec le fournisseur.

Les clés sont stockées cryptées sur votre machine. Si une clé ne fonctionne plus partout, remplacez-la chez le fournisseur plutôt que de réinstaller 9xchat.

Un modèle local ne se connectera pas

1. Démarrez votre coureur local et confirmez qu'il répond en dehors de 9xchat.
2. Vérifiez qu’il écoute à l’adresse et sur le port attendus par 9xChat.
3. Confirmez que le modèle lui-même est tiré et chargé, et pas seulement le coureur en marche.
4. Rouvrez Bibliothèque → Modèles pour que la liste soit actualisée.

Les modèles locaux n’ont besoin ni de clé ni de crédits. Si un modèle local fonctionne et pas un modèle cloud, le problème vient de votre clé, de votre solde ou du réseau.

Un outil ou un serveur MCP ne fonctionne pas

1. Vérifiez que l'outil est activé. Chaque outil dispose d'un commutateur Activé sous Bibliothèque → Outils.

2. Vérifiez le forfait. Les outils d’agents et la recherche Web en direct nécessitent Pro. Consultez Gratuit et Pro.

3. Lisez la ligne de sécurité. Elle indique les autorisations dont l'outil a besoin. Un outil qui ne peut pas atteindre ce dont il a besoin échoue plutôt que de demander.

4. Pour les serveurs MCP, confirmez que les secrets requis ont été fournis : une entrée toujours marqué Configuration requise n'a pas été configuré. L'aperçu de la configuration montre la commande exacte qu'il exécute, ce qui mérite d'être relu si le serveur ne démarre jamais.

5. Isolez-le. Désactivez l'outil, posez la même question et voyez si le changements de comportement. Cela vous indique si l'outil est impliqué ou non.

La recherche de connaissances ne trouve rien

Une collection doit être indexée avant de pouvoir être recherchée.

• Confirmez que les fichiers ont été ajoutés à une collection, et pas seulement attachés à une discussion.
• Vérifiez que l'outil Search Knowledge est activé.
• Si votre fournisseur d'intégrations était inaccessible lorsque vous avez ajouté les fichiers, la recherche revient à la correspondance de mots clés et manquera tout ce qui nécessitait l'index. Ajoutez à nouveau les fichiers une fois que le fournisseur est joignable.

Voir Connaissances et souvenirs.

Une pièce jointe ne sera pas traitée

• Confirmez que le modèle que vous avez sélectionné accepte ce type de fichier. Un modèle texte uniquement ne peut pas lire une image et la liste des modèles marque les marques qui gèrent la vision.
• Les fichiers très volumineux peuvent dépasser le contexte d'un modèle. Essayez un extrait plus petit ou un modèle avec une fenêtre contextuelle plus grande.
• Si le fichier s'ouvre correctement ailleurs mais échoue ici, essayez de le convertir en format commun en premier.

La génération d'images échoue

• La retouche d’une zone d’image, la régénération d’une image générée et les images dans les conversations nécessitent Pro. L’espace d’expérimentation d’images est gratuit.
• Vérifiez qu’un modèle d’images est sélectionné. Il se choisit indépendamment de votre modèle de discussion.
• Vérifiez votre solde créditeur si vous générez via des crédits 9xchat.
• Certains prompts sont refusés par le fournisseur et non par 9xChat ; les reformuler est généralement plus rapide que de réessayer.

La dictée ou la lecture à haute voix échoue

Les deux ont besoin d’un fournisseur audio fonctionnel et aucun n’a d’option locale.

• Confirmez que votre Fournisseur de transcriptionest défini sousParamètres → Par défaut. Modèles.
• Accordez à 9xChat l’accès au microphone dans les paramètres de confidentialité de votre système d’exploitation. Sur macOS, Réglages Système → Confidentialité et sécurité → Microphone.
• Les deux ont besoin d’une connexion même lorsque votre modèle de discussion est local.

La dictée et les conversations vocales nécessitent Pro ; la lecture à voix haute est gratuite.

Les crédits s'épuisent plus vite que prévu

Chaque message affiche son propre coût, sa latence et sa répartition des jetons, et la session affiche un total cumulé. Si un total semble erroné, ouvrez les chiffres par message pour voir quel échange en tient compte : un contexte long, des jetons de raisonnement et des pièces jointes volumineuses augmentent tous le coût d'un seul tour.

Vous pouvez limiter ce montant par conversation en réduisant le nombre maximal de jetons d'achèvement et la limite de contexte dans les paramètres du modèle, et Context Shield réduit la quantité d'historique renvoyé avec chaque message.

Pour arrêter complètement de dépenser des crédits, ajoutez votre propre clé API ou utilisez un modèle local.

Une fonctionnalité est grisée ou manquante

Les fonctions nécessitant Pro ouvrent une boîte de dialogue Fonction Pro sur un compte gratuit, et les paramètres Pro portent le libellé Premium : notamment les onglets multiples, la fenêtre de conversation, l’assistant rapide, les outils d’agents, la recherche Web en direct, la retouche d’images, la dictée et les conversations vocales. Gratuit et Pro présente la répartition complète.

Si vous payez déjà, vérifiez que cet appareil est connecté avec l’UID portant l’abonnement. Ouvrez Profil pour vérifier le forfait et les jours restants. Suivez Votre UID et vos appareils pour connecter, changer ou supprimer un appareil.

« Pas assez de crédits pour cette requête »

La requête coûte plus que votre solde restant. Choisissez Acheter des crédits, ou passez la conversation à un modèle utilisant votre propre clé API ou à un modèle local : ils ne consomment jamais de crédits. Votre solde figure dans Profil.

« Limite d’appareils atteinte »

Tous les emplacements d’appareils de votre UID sont occupés : un sur un compte gratuit ou pendant l’essai, trois avec Pro. Choisissez Gérer les appareils et supprimez un appareil inutilisé (sur iOS, utilisez la page de licence dans un navigateur), puis reconnectez-vous. Ne créez pas de nouvel UID : il ne reprendrait ni votre forfait ni vos crédits. Consultez Votre UID et vos appareils.

« Paiement non détecté »

Après le paiement dans le navigateur, 9xChat vérifie votre compte lorsque vous choisissez Confirmer le paiement. Si Paiement non détecté s’affiche, le traitement est peut-être en cours : attendez une minute, puis choisissez Réessayer. Si vous avez fermé la page de paiement par erreur, choisissez Ouvrir la page de paiement. Les achats sur Google Play ou l’App Store peuvent être récupérés avec Restaurer les achats sur l’écran des tarifs.

Un code Handoff ne fonctionne pas

• Les codes expirent après quelques minutes et ne servent qu’une fois. Annulez sur l’appareil émetteur et choisissez à nouveau Obtenir un code d’appairage.
• Saisissez les 6 chiffres sur l’appareil destinataire sous Recevoir une conversation….
• Gardez les deux boîtes de dialogue ouvertes et les deux appareils en ligne jusqu’à la fin du transfert.

Consultez Handoff.

Il manque quelque chose sur un autre appareil

Votre espace de travail est stocké localement sur chaque appareil, donc une deuxième machine connectée avec le même UID n'hérite pas de vos discussions, notes ou souvenirs. C’est une attente plutôt qu’une faute.

• Les mémoires sont par appareil. Une nouvelle installation démarre sans aucune.
• Handoff associe deux appareils pour une conversation ; ça ne copie pas le reste de votre espace de travail.
• Pour déplacer du matériel vous-même, utilisez Paramètres → Données et exportations.

Votre abonnement suit l'UID, donc un appareil qui vérifie avec celui-ci récupère Pro même si le contenu ne voyage pas.

Rien ici n'a aidé

Cochez Inclure les diagnostics lorsque vous nous écrivez. Cela joint les versions, les chiffres de stockage, les décomptes et les catégories d’erreurs récentes, jamais vos prompts, titres, noms de fichiers ou clés. C’est le moyen le plus rapide d’éviter un échange de questions, et Confidentialité détaille exactement ce qui est transmis.

Contactez support avec :

• votre système d’exploitation et la version de 9xChat,
• le modèle et le fournisseur que vous utilisiez,
• que vous ayez des crédits, votre propre clé ou un modèle local,
• ce que vous avez fait et l'erreur visible exacte.