FAQ

Ce document a été traducido del chino por IA y aún no ha sido revisado.

Foire aux questions (FAQ)

Codes d'erreur courants

• 4xx (Codes d'état d'erreur client) : Généralement des erreurs de syntaxe de requête, d'authentification ou d'autorisation empêchant le traitement de la requête.

• 5xx (Codes d'état d'erreur serveur) : Généralement des erreurs côté serveur comme un serveur inaccessible ou des délais de traitement dépassés.

Code d'erreur	Cas possibles	Solution
400	Format incorrect du corps de la requête, etc.	Vérifiez le contenu de l'erreur renvoyé dans la conversation ou consultez la console pour voir le message d'erreur, puis suivez les instructions. [Cas fréquent 1] : Pour les modèles Gemini, une activation de carte bancaire peut être nécessaire ; [Cas fréquent 2] : Taille de données dépassée (surtout avec les modèles visuels). Les images dépassant la limite de taille renverront cette erreur ; [Cas fréquent 3] : Paramètre non supporté ou mal configuré. Testez avec un assistant vierge ; [Cas fréquent 4] : Limite de contexte dépassée. Effacez le contexte, démarrez une nouvelle conversation ou réduisez le nombre de messages contextuels.
401	Authentification échouée : modèle non supporté ou compte banni	Contactez le fournisseur de services ou vérifiez l'état du compte
403	Droits insuffisants pour l'opération	Suivez les instructions de l'erreur renvoyée ou dans la console
404	Ressource introuvable	Vérifiez le chemin de la requête
422	Syntaxe correcte mais erreur sémantique	Erreur dans l'interprétation JSON (ex: valeur nulle ; nombre/boolean au lieu d'une chaîne)
429	Limite de taux de requête atteinte	Attendez avant de réessayer (dépassement TPM ou RPM)
500	Erreur interne du serveur	Contactez le fournisseur de services si persistant
501	Fonctionnalité non supportée
502	Réponse invalide d'un serveur intermédiaire
503	Serveur surchargé/en maintenance	Vérifiez l'en-tête Retry-After pour le délai
504	Délai dépassé par un serveur intermédiaire

---

Comment voir les erreurs dans la console

• Cliquez sur la fenêtre du client Cherry Studio, puis appuyez sur le raccourci clavier Ctrl + Shift + I (macOS : Command + Option + I)

• La fenêtre active doit être celle du client Cherry Studio pour ouvrir la console ;

• Ouvrez la console avant de lancer des tests ou des requêtes pour collecter les informations.

• Dans la console ouverte, cliquez sur Network → Cherchez dans la zone ② le dernier élément marqué d'un × rouge nommé completions (pour les erreurs de dialogue/traduction) ou generations (pour les erreurs de génération d'images) → Cliquez sur Response pour voir le message complet (zone ④ sur l'image).

Si vous ne parvenez pas à identifier la cause de l'erreur, envoyez une capture d'écran de cette interface au groupe de discussion officiel.

Cette méthode fonctionne aussi pour les tests de modèles, l'ajout de bases de connaissances, ou la génération d'images. Ouvrez toujours la console avant de lancer les opérations.

Les noms dans la colonne Name (zone ②) varient selon le contexte :

Dialogues/traduction/vérification de modèle : completions

Génération d'images : generations

Création de base de connaissances : embeddings

---

Formules non rendues / Erreurs de rendu

• Si les formules s'affichent en code, vérifiez les délimiteurs :

Utilisation des délimiteurs

Formule en ligne

• Un dollar unique : $formule$

• Ou \( et \) : \(formule\)

Bloc de formule

• Deux dollars : $$formule$$

• Ou \[formule\]

• Exemple : $$\sum_{i=1}^n x_i$$ $\sum_{i=1}^n x_i$

• Si le rendu est corrompu (surtout avec du chinois dans les formules), basculez vers le moteur de rendu KateX.

---

Impossible de créer une base de connaissances / Échec de récupération des dimensions d'embedding

1. Modèle indisponible

Vérifiez si le fournisseur supporte ce modèle ou son état de service.

1. Utilisation d'un modèle non-embedding

---

Le modèle ne reconnaît pas les images / Impossible d'uploader/sélectionner des images

Vérifiez d'abord si le modèle supporte la reconnaissance d'images. Dans Cherry Studio, les modèles populaires sont classés : une icône d'œil 👁️ après le nom indique cette capacité.

Les modèles compatibles permettent l'upload d'images. Si cette option n'apparaît pas, dans la liste des modèles du fournisseur, cliquez sur l'icône de paramètres et cochez "Image".

Les spécifications des modèles sont disponibles chez chaque fournisseur. Comme pour les embeddings, cocher l'option sur des modèles non-visuels n'aura aucun effet.