Utilisez ce guide pour diagnostiquer et résoudre les problèmes courants qui surviennent lorsque vous appelez l'API Gemini. Si vous rencontrez des problèmes de clé API, vérifiez que vous avez correctement configuré votre clé API conformément au guide de configuration des clés API.
Codes d'erreur
Le tableau suivant répertorie les codes d'erreur courants que vous pouvez rencontrer, ainsi que des explications sur leurs causes et les étapes de dépannage:
| Code HTTP | État | Description | Solution |
| 400 | INVALID_ARGUMENT | Le format du corps de la requête est incorrect. | Consultez la documentation de référence de l'API pour connaître le format de requête, des 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. |
| 403 | PERMISSION_DENIED | Votre clé API ne dispose pas des autorisations requises. | Vérifiez que votre clé API est définie et dispose des droits d'accès appropriés. |
| 404 | NOT_FOUND | La ressource demandée est introuvable. | Vérifiez que 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 requêtes. | Assurez-vous de respecter la limite de débit du modèle. Demandez une augmentation de quota si nécessaire. |
| 500 | INTERNE | Une erreur inattendue s'est produite du côté de Google. | Veuillez patienter quelques instants, puis relancez votre requête. Si le problème persiste après une nouvelle tentative, veuillez le signaler à l'aide du bouton Envoyer des commentaires de Google AI Studio. |
| 503 | UNAVAILABLE | Le service peut être temporairement surchargé ou en panne. | Veuillez patienter quelques instants, puis relancez votre requête. Si le problème persiste après une nouvelle tentative, veuillez le signaler à l'aide du bouton Envoyer des commentaires de Google AI Studio. |
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 sont compris entre 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 bonne version d'API (par exemple, /v1 ou /v1beta) et un modèle compatible avec les fonctionnalités dont vous avez besoin. Par exemple, si une fonctionnalité est en version bêta, elle ne sera disponible que dans la version d'API /v1beta.
Vérifier si vous disposez du bon modèle
Assurez-vous d'utiliser un modèle compatible. Utilisez list_models (Python) pour obtenir tous les modèles disponibles.
Problèmes de sécurité
Si vous voyez qu'une invite a été bloquée en raison d'un paramètre de sécurité dans votre appel d'API, vérifiez-la en fonction des filtres que vous avez définis dans l'appel d'API.
Si BlockedReason.OTHER s'affiche, il est possible que la requête ou la réponse enfreignent les Conditions d'utilisation ou ne soient pas compatibles.
Améliorer la sortie du modèle
Pour obtenir des résultats de modèles de meilleure qualité, essayez de rédiger des requêtes plus structurées. La page Présentation de la conception de requête présente des concepts, des stratégies et des bonnes pratiques de base pour vous aider à démarrer.
Si vous disposez de centaines d'exemples de paires d'entrées/sorties satisfaisantes, vous pouvez également envisager d'ajuster le modèle.
Comprendre les limites de jetons
Utilisez l'API ModelService pour obtenir des métadonnées supplémentaires sur les modèles, y compris les limites des jetons d'entrée et de sortie.
Pour obtenir les jetons utilisés par votre requête, utilisez countMessageTokens pour les modèles de chat et countTextTokens pour les modèles de texte.
Problèmes connus
- Compatibilité avec Google AI Studio sur mobile: il est possible d'ouvrir le site Web sur mobile, mais il n'a pas été optimisé pour les petits écrans.
- L'API n'est disponible qu'en anglais. L'envoi de requêtes dans différentes langues peut produire des réponses inattendues, voire bloquées. Consultez la liste des langues disponibles pour obtenir les mises à jour.
Signaler un bug
Signalez un problème dans GitHub pour poser des questions, soumettre des demandes de fonctionnalités ou soumettre des bugs.