Ce guide vous aidera à diagnostiquer et à résoudre les problèmes courants vous appelez l'API Gemini. Si vous rencontrez des problèmes de clé API, assurez-vous d'avoir configuré votre clé API en suivant les instructions du 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 les causes et des procédures de dépannage:
| Code HTTP | État | Description | Solution |
| 400 | INVALID_ARGUMENT | Le corps de la requête est mal formé. | Consultez la documentation de référence de l'API pour connaître le format de la requête, des exemples et les versions compatibles. L'utilisation des 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 | La version sans frais de l'API Gemini n'est pas disponible dans votre pays. Veuillez activer 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. | Vérifiez que votre clé API est définie et dispose du bon accès. |
| 404 | NOT_FOUND | La ressource demandée est introuvable. | Vérifiez si tous les paramètres de votre requête sont valides pour la version de votre API. |
| 429 | RESOURCE_EXHAUSTED | Vous avez dépassé la limite de trafic. | Vérifiez que vous vous trouvez dans la limite de débit du modèle. Si nécessaire, demandez une augmentation de quota. |
| 500 | INTERNAL | Une erreur inattendue s'est produite côté Google. | Patientez un peu et relancez votre requête. Si le problème persiste après une nouvelle tentative, veuillez le signaler à l'aide du bouton Envoyer des commentaires dans Google AI Studio. |
| 503 | UNAVAILABLE | Le service est peut-être temporairement surchargé ou en panne. | Patientez un peu et relancez votre requête. Si le problème persiste après une nouvelle tentative, veuillez le signaler à l'aide du bouton Envoyer des commentaires dans Google AI Studio. |
Rechercher les erreurs de paramètres du modèle dans vos appels d'API
Assurez-vous que les paramètres de votre modèle sont compris dans 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 les bonnes
Version de l'API (par exemple, /v1 ou /v1beta) et
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 de l'API /v1beta.
Vérifier que vous disposez du bon modèle
Assurez-vous d'utiliser un modèle compatible listé dans notre du modèle.
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, Examinez la requête par rapport aux filtres que vous avez définis dans l'appel d'API.
Si le message BlockedReason.OTHER s'affiche, il est possible que la requête ou la réponse enfreignent les conditions
de service ou n'est pas compatible.
Améliorer la sortie du modèle
Pour obtenir des résultats de modèle de meilleure qualité, envisagez de rédiger des requêtes plus structurées. La introduction à la conception de requête présente quelques concepts de base, stratégies et bonnes pratiques pour bien démarrer.
Si vous disposez de centaines d'exemples de bonnes paires entrée/sortie, vous pouvez également pensez au réglage de modèle.
Comprendre les limites de jetons
Consultez notre guide des jetons pour mieux comprendre pour compter les jetons et leurs limites.
Problèmes connus
- L'API n'est disponible qu'en anglais. L'envoi de requêtes dans différentes langues peut générer des réponses inattendues, voire bloquées. Voir les disponibles langues pour plus d'informations.
Signaler un bug
Participez à la discussion sur le forum des développeurs IA de Google si vous avez des questions.