Guide de dépannage

Utilisez ce guide pour vous aider à diagnostiquer et à résoudre les problèmes courants qui surviennent lorsque vous appelez l'API Gemini. Vous pouvez rencontrer des problèmes provenant du service de backend de l'API Gemini ou des SDK client. Nos SDK clients sont disponibles en Open Source dans les référentiels suivants:

Si vous rencontrez des problèmes avec une clé API, assurez-vous de l'avoir correctement configurée conformément au guide de configuration des clés API.

Codes d'erreur du service backend de l'API Gemini

Le tableau suivant répertorie les codes d'erreur de backend courants que vous pouvez rencontrer, ainsi que les explications sur leurs causes et la procédure de dépannage:

Code HTTP État Description Exemple Solution
400 INVALID_ARGUMENT Le corps de la requête est mal formé. Votre demande contient une faute de frappe ou un champ obligatoire est manquant. Consultez la documentation de référence de l'API pour connaître le format des requêtes, les exemples et les versions compatibles. L'utilisation de fonctionnalités d'une version d'API plus récente avec un point de terminaison plus ancien peut entraîner des erreurs.
400 FAILED_PRECONDITION Le niveau sans frais de l'API Gemini n'est pas disponible dans votre pays. Veuillez activer la facturation dans votre projet dans Google AI Studio. Vous envoyez une requête dans une région où le niveau sans frais n'est pas disponible et vous n'avez pas activé la facturation pour votre projet dans Google AI Studio. Pour utiliser l'API Gemini, vous devez configurer un forfait payant à l'aide de Google AI Studio.
403 PERMISSION_DENIED Votre clé API ne dispose pas des autorisations requises. Vous utilisez la mauvaise clé API. Vous essayez d'utiliser un modèle affiné sans passer par une authentification appropriée. Vérifiez que votre clé API est définie et qu'elle dispose des droits d'accès appropriés. Veillez également à effectuer une authentification appropriée pour utiliser les modèles optimisés.
404 NOT_FOUND La ressource demandée est introuvable. Un fichier image, audio ou vidéo référencé dans votre requête n'a pas été trouvé. Vérifiez si tous les paramètres de votre requête sont valides pour votre version d'API.
429 RESOURCE_EXHAUSTED Vous avez dépassé la limite de débit. Vous envoyez trop de requêtes par minute avec l'API Gemini de niveau sans frais. Assurez-vous de respecter la limite de débit du modèle. Demandez une augmentation de quota si nécessaire.
500 INTERNAL Une erreur inattendue s'est produite de la part de Google. Le contexte de saisie est trop long. Réduisez le contexte d'entrée ou passez temporairement à un autre modèle (par exemple, de Gemini 1.5 Pro à Gemini 1.5 Flash) pour voir si le problème est résolu. Vous pouvez également patienter quelques instants et réessayer. Si le problème persiste après la nouvelle tentative, veuillez le signaler à l'aide du bouton Envoyer des commentaires dans Google AI Studio.
503 UNAVAILABLE Il est possible que le service soit temporairement surchargé ou en panne. Le service est temporairement saturé. Passez temporairement à un autre modèle (par exemple, de Gemini 1.5 Pro à Gemini 1.5 Flash) et vérifiez si le problème est résolu. Vous pouvez également patienter quelques instants et réessayer. Si le problème persiste après la nouvelle tentative, veuillez le signaler à l'aide du bouton Envoyer des commentaires dans Google AI Studio.
504 DEADLINE_EXCEEDED Le service ne parvient pas à terminer le traitement dans le délai imparti. Votre requête (ou contexte) est trop volumineuse pour être traitée à temps. Définissez un délai avant expiration plus long dans votre requête client pour éviter cette erreur.

Codes d'erreur du SDK client

Vérifier les erreurs de paramètres de modèle dans vos appels d'API

Assurez-vous que les paramètres de votre modèle respectent les valeurs suivantes:

Paramètre du modèle Valeurs (plage)
Nombre de candidats 1 à 8 (entier)
Température 0,0-1,0
Nombre maximal de jetons de sortie Utilisez get_model (Python) pour déterminer le nombre maximal de jetons pour le modèle que vous utilisez.
TopP 0,0-1,0

En plus de vérifier les valeurs des paramètres, assurez-vous d'utiliser la version d'API appropriée (par exemple, /v1 ou /v1beta) et le modèle compatible avec les fonctionnalités dont vous avez besoin. Par exemple, si une fonctionnalité est en version bêta, elle n'est disponible que dans la version de l'API /v1beta.

Vérifier que vous disposez du bon modèle

Assurez-vous d'utiliser un modèle compatible figurant sur notre page des modèles.

Problèmes de sécurité

Si vous constatez qu'une invite a été bloquée en raison d'un paramètre de sécurité dans votre appel d'API, examinez-la par rapport aux filtres que vous avez définis dans l'appel d'API.

Si vous voyez BlockedReason.OTHER, la requête ou la réponse peut ne pas respecter les Conditions d'utilisation ou ne pas être prise en charge.

Problème de récitation

Si vous constatez que le modèle cesse de générer une sortie pour la raison RECITATION, cela signifie que la sortie du modèle peut ressembler à certaines données. Pour résoudre ce problème, essayez de rendre la requête / le contexte aussi unique que possible et utilisez une température plus élevée.

Améliorer la sortie du modèle

Pour obtenir des sorties de modèle de meilleure qualité, essayez d'écrire des requêtes plus structurées. La page Présentation de la conception des requêtes présente des concepts, des stratégies et des bonnes pratiques de base pour vous aider à vous lancer.

Si vous disposez de centaines d'exemples de bonnes paires entrée/sortie, vous pouvez également envisager de régler le modèle.

Comprendre les limites des jetons

Consultez notre guide des jetons pour mieux comprendre comment compter les jetons et leurs limites.

Problèmes connus

  • L'API n'est compatible qu'avec certaines langues. Envoyer des requêtes dans des langues non acceptées peut générer des réponses inattendues, voire bloquées. Pour en savoir plus, consultez la liste des langues disponibles.

Signaler un bug

Si vous avez des questions, participez à la discussion sur le forum des développeurs Google AI.