Cette page explique comment résoudre les codes d'erreur courants pour les SDK Gemini API et Firebase AI Logic.
Erreur 400 : API key not valid. Please pass a valid API key.
Si vous recevez une erreur 400 indiquant API key not valid. Please pass a valid API key., cela signifie généralement que la clé API de votre fichier/objet de configuration Firebase n'existe pas ou n'est pas configurée pour être utilisée avec votre application et/ou votre projet Firebase.
Vérifiez que la clé API listée dans votre fichier/objet de configuration Firebase correspond à la clé API de votre application. Vous pouvez afficher toutes vos clés API dans le panneau API et services > Identifiants de la console Google Cloud.
Si vous constatez qu'ils ne correspondent pas, obtenez un nouveau fichier/objet de configuration Firebase, puis remplacez celui qui se trouve dans votre application. Le nouveau fichier/objet de configuration doit contenir une clé API valide pour votre application et votre projet Firebase.
Erreur 400 : Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.
Si vous essayez d'envoyer une requête multimodale avec une URL Cloud Storage for Firebase, vous pouvez rencontrer l'erreur 400 suivante :
Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.
Cette erreur est due à un projet pour lequel les agents de service requis n'ont pas été provisionnés automatiquement de manière correcte lorsque l'API Agent Platform a été activée dans le projet. Il s'agit d'un problème connu qui touche certains projets, et nous travaillons à un correctif global.
Voici la solution de contournement pour corriger votre projet et provisionner correctement ces agents de service afin que vous puissiez commencer à inclure des URL Cloud Storage for Firebase dans vos requêtes multimodales. Vous devez être propriétaire du projet et n'effectuer cet ensemble de tâches qu'une seule fois pour votre projet.
Accédez à l'gcloud CLI et authentifiez-vous.
Le moyen le plus simple de le faire est d'utiliser Cloud Shell. Pour en savoir plus, consultez la documentation sur Google Cloud.Si vous y êtes invité, suivez les instructions affichées dans le terminal pour exécuter gcloud CLI sur votre projet Firebase.
Vous aurez besoin de l'ID de votre projet Firebase, que vous trouverez en haut de la page settingsParamètres du projet dans la console Firebase.
Provisionnez les agents de service requis dans votre projet en exécutant la commande suivante :
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/endpoints -d ''
Attendez quelques minutes pour vous assurer que les agents de service sont provisionnés, puis réessayez d'envoyer votre requête multimodale incluant l'URL Cloud Storage for Firebase.
Si cette erreur persiste après plusieurs minutes, contactez l'assistance Firebase.
Erreur 403 : PERMISSION_DENIED: To access this model, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check
Si vous recevez une erreur 403 - PERMISSION_DENIED indiquant To access this model, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check, cela signifie que votre requête ne comporte pas de jeton App Check valide et que vous essayez d'accéder à un modèle qui fait souvent l'objet d'abus.
Certains modèles génératifs ont été identifiés comme étant couramment utilisés par des personnes malveillantes.
Sans App Check, votre projet est vulnérable à l'utilisation abusive de ces modèles. Pour protéger nos développeurs, Firebase bloque l'accès à ces modèles, sauf si vos requêtes incluent un jeton App Check valide (ce qui nécessite l'application de App Check pour Firebase AI Logic).
Si vous souhaitez accéder au modèle qui a renvoyé l'erreur, procédez comme suit :
Configurez App Check pour Firebase AI Logic. Pour le développement local, assurez-vous de configurer le fournisseur de débogage App Check.
Si vous avez déjà configuré App Check, vérifiez que vous avez bien suivi toutes les étapes des instructions associées.
Renvoyez la requête de votre application à Firebase AI Logic.
Cette requête enverra un jeton App Check valide, et vous ne recevrez plus l'erreur 403.
L'erreur 403 persiste ?
Si App Check est appliqué et que vous avez envoyé une requête, mais que vous obtenez toujours l'erreur 403, vérifiez si la protection contre la relecture est appliquée pour Firebase AI Logic (y compris en mode "Surveillance uniquement").
Lorsque la protection contre les attaques de répétition est appliquée, seuls les jetons à usage limité sont considérés comme validés pour Firebase AI Logic. Cela signifie que les jetons de session standards ne peuvent pas résoudre cette erreur 403. Pour résoudre ce problème, effectuez l'une des opérations suivantes :
Option 1 : Si vous souhaitez utiliser la protection contre le rejeu, vérifiez la configuration de la protection contre le rejeu.
Assurez-vous d'avoir suivi toutes les étapes pour configurer la protection contre les attaques de répétition, y compris l'activation des jetons à usage limité dans le codebase de votre application.
Renvoyez une demande à Firebase AI Logic.
Option 2 : Si vous ne souhaitez pas utiliser la protection contre la relecture ou si vous n'avez pas activé les jetons à usage limité dans votre application, vous pouvez désactiver la protection contre la relecture.
Désactivez la protection contre les attaques par rejeu dans la console Firebase : accédez à l'onglet Sécurité > App Check > API, cliquez pour développer la ligne Firebase AI Logic, cliquez sur Configurer, puis désactivez la protection contre les attaques par rejeu dans la boîte de dialogue.
Renvoyez une demande à Firebase AI Logic.
Avant de publier votre application auprès des utilisateurs finaux, vous devez configurer un fournisseur d'attestation de production (comme App Attest, Play Integrity ou reCAPTCHA Enterprise) afin que vos utilisateurs finaux puissent accéder à votre fonctionnalité d'IA lorsque App Check est appliqué.
Erreur 403 : PERMISSION_DENIED: Firebase AI Logic has been deactivated in this project. To resume using Firebase AI Logic, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check
Si vous recevez une erreur 403 - PERMISSION_DENIED indiquant Firebase AI Logic has been deactivated in this project. To resume using
Firebase AI Logic, you must enforce Firebase App Check. Learn more:
https://firebase.google.com/docs/ai-logic/app-check, cela signifie que votre projet Firebase a été identifié comme inactif et que les requêtes de votre application ne disposent pas d'un jeton App Check valide.
Les "projets inactifs" sont ceux pour lesquels Firebase AI Logic est activé, mais qui n'ont pas utilisé Firebase AI Logic récemment.
Sans App Check, votre projet est vulnérable aux utilisations abusives de Gemini API. Pour protéger votre projet, Firebase a désactivé l'utilisation de Firebase AI Logic jusqu'à ce que vos requêtes incluent un jeton App Check valide (ce qui nécessite que App Check soit appliqué pour Firebase AI Logic).
Lorsque vous êtes prêt à recommencer à utiliser Firebase AI Logic, procédez comme suit :
Configurez App Check pour Firebase AI Logic. Pour le développement local, assurez-vous de configurer le fournisseur de débogage App Check.
Si vous avez déjà configuré App Check, vérifiez que vous avez bien suivi toutes les étapes des instructions associées.
Renvoyez la requête de votre application à Firebase AI Logic.
Cette requête enverra un jeton App Check valide, et vous ne recevrez plus l'erreur 403.
L'erreur 403 persiste ?
Si App Check est appliqué et que vous avez envoyé une requête, mais que vous obtenez toujours l'erreur 403, vérifiez si la protection contre la relecture est appliquée pour Firebase AI Logic (y compris en mode "Surveillance uniquement").
Lorsque la protection contre les attaques de répétition est appliquée, seuls les jetons à usage limité sont considérés comme validés pour Firebase AI Logic. Cela signifie que les jetons de session standards ne peuvent pas résoudre cette erreur 403. Pour résoudre ce problème, effectuez l'une des opérations suivantes :
Option 1 : Si vous souhaitez utiliser la protection contre le rejeu, vérifiez la configuration de la protection contre le rejeu.
Assurez-vous d'avoir suivi toutes les étapes pour configurer la protection contre les attaques de répétition, y compris l'activation des jetons à usage limité dans le codebase de votre application.
Renvoyez une demande à Firebase AI Logic.
Option 2 : Si vous ne souhaitez pas utiliser la protection contre la relecture ou si vous n'avez pas activé les jetons à usage limité dans votre application, vous pouvez désactiver la protection contre la relecture.
Désactivez la protection contre les attaques par rejeu dans la console Firebase : accédez à l'onglet Sécurité > App Check > API, cliquez pour développer la ligne Firebase AI Logic, cliquez sur Configurer, puis désactivez la protection contre les attaques par rejeu dans la boîte de dialogue.
Renvoyez une demande à Firebase AI Logic.
Avant de publier votre application auprès des utilisateurs finaux, vous devez configurer un fournisseur d'attestation de production (comme App Attest, Play Integrity ou reCAPTCHA Enterprise) afin que vos utilisateurs finaux puissent accéder à votre fonctionnalité d'IA lorsque App Check est appliqué.
Erreur 403 : PERMISSION_DENIED: The caller does not have permission.
Si vous recevez une erreur 403 indiquant PERMISSION_DENIED: The caller does not have permission., cela signifie généralement que la clé API de votre fichier/objet de configuration Firebase appartient à un autre projet Firebase.
Vérifiez que la clé API listée dans votre fichier/objet de configuration Firebase correspond à la clé API de votre application. Vous pouvez afficher toutes vos clés API dans le panneau API et services > Identifiants de la console Google Cloud.
Si vous constatez qu'ils ne correspondent pas, obtenez un nouveau fichier/objet de configuration Firebase, puis remplacez celui qui se trouve dans votre application. Le nouveau fichier/objet de configuration doit contenir une clé API valide pour votre application et votre projet Firebase.
Erreur 403 : Requests to this API firebasevertexai.googleapis.com ... are blocked.
Si vous recevez une erreur 403 indiquant Requests to this API firebasevertexai.googleapis.com ... are blocked., cela signifie généralement que la clé API de votre configuration Firebase dans votre application comporte des restrictions qui l'empêchent d'appeler l'API requise.
Pour résoudre ce problème, vous devez modifier les restrictions de votre clé API dans la console Google Cloud afin d'inclure l'API requise. Pour Firebase AI Logic, vous devez vous assurer que l'API Firebase AI Logic (firebasevertexai.googleapis.com) est incluse dans la liste des API sélectionnées qui peuvent être appelées à l'aide de la clé API.
Procédez comme suit :
Dans la consoleGoogle Cloud, ouvrez le panneau API et services > Identifiants.
Sélectionnez la clé API que votre application est configurée pour utiliser (par exemple, la "clé iOS" pour une application iOS).
Sur la page Modifier la clé API, accédez à la section Restrictions relatives aux API.
Assurez-vous que l'option Restreindre la clé est sélectionnée. Si ce n'est pas le cas, votre clé n'est pas limitée, et il est peu probable que l'erreur vienne de là.
Dans le menu déroulant API sélectionnées, recherchez et sélectionnez l'API Firebase AI Logic pour l'ajouter à la liste des API sélectionnées qui peuvent être appelées à l'aide de la clé API.
Cliquez sur Enregistrer.
La prise en compte des modifications peut prendre jusqu'à cinq minutes.
Erreur 404 : Firebase AI Logic genai config not found
Si vous recevez une erreur 404 indiquant Firebase AI Logic genai config not found, cela signifie généralement qu'un paramètre de Firebase AI Logic est mal configuré ou manquant.
Voici les causes les plus probables de cette erreur :
Vous n'avez pas encore configuré votre projet Firebase pour un fournisseur Gemini API.
Procédure à suivre :
Dans la console Firebase, accédez à Services d'IA > Logique d'IA. Cliquez sur Commencer, puis sélectionnez le fournisseur Gemini API de votre choix. Activez l'API, et Firebase configurera votre projet pour ce fournisseur. Une fois le workflow terminé, relancez votre requête.Si vous avez récemment suivi le workflow de configuration de Firebase AI Logic dans la console Firebase, il est possible que la configuration de Firebase AI Logic ne soit pas encore disponible pour tous les services de backend requis dans toutes les régions applicables.
Que faire ?
Patientez quelques minutes, puis réessayez.
Erreur 404 : le modèle "was not found or your project does not have access to it" ?
Exemple : "Publisher Model projects/PROJECT-ID/locations/us-central1/publishers/google/models/gemini-3.1-pro-preview was not found or your project does not have access to it. Please ensure you are using a valid model version."
Plusieurs raisons peuvent expliquer ce type d'erreur.
Nom de modèle non valide
Cause : Le nom de modèle que vous avez fourni n'est pas valide.
Correction : vérifiez le nom et la version de votre modèle par rapport à la liste de tous les modèles compatibles et disponibles. Veillez à vérifier les segments et leur ordre dans le nom du modèle. Exemple :
- Dernière activité Gemini 4 Hydrogen
Nom du modèle :
gemini-4-hydrogen - Dernière activité Gemini 4 Argon
Nom du modèle :
gemini-4-argon - Dernière activité Gemini 4 Carbon
Nom du modèle :
gemini-4-carbon - Dernière activité Gemini 3.x Flash
Nom du modèle :
gemini-3.8-flash - Dernière activité Gemini 3.x Flash‑Lite
Nom du modèle :
gemini-3.5-flash-lite - Dernière activité Gemini Nano Banana 2.1
Nom du modèle :
gemini-nano-banana-2.1 - Dernière activité Gemini Nano Banana 2
Nom du modèle :
gemini-3.1-flash-image - Dernière activité Gemini Nano Banana 2 Lite
Nom du modèle :
gemini-3.1-flash-lite-image - Dernière activité Gemini Nano Banana Pro
Nom du modèle :
gemini-3-pro-image
- Dernière activité Gemini 4 Hydrogen
Nom du modèle :
Modèle arrêté (retiré)
Cause : Le modèle auquel vous essayez d'accéder a dépassé sa date d'arrêt (retrait) et a été désactivé de manière définitive (par exemple, les modèles Gemini 2.5 à usage général sur Agent Platform Gemini API (formerly Vertex AI), les modèles Gemini 2.0 ou les modèles Imagen).
Correction : consultez les questions fréquentes sur les modèles obsolètes et arrêtés, puis mettez à jour votre code pour utiliser un modèle de remplacement actif.
Emplacement non valide (applicable uniquement si vous utilisez le fournisseur Agent Platform Gemini API (formerly Vertex AI))
Cause : Votre requête tente peut-être d'accéder à un modèle dans un emplacement où il n'est pas disponible.
Solution : Assurez-vous que votre requête tente d'accéder au modèle là où il est disponible.
Lorsque vous utilisez Agent Platform Gemini API (formerly Vertex AI), vous pouvez éventuellement spécifier un emplacement pour accéder au modèle lors de l'initialisation. Si vous ne spécifiez pas d'emplacement, Firebase AI Logic utilise par défaut les emplacements suivants :
- Lorsque vous utilisez la syntaxe d'initialisation "Agent Platform" :
global - Lorsque vous utilisez l'ancienne syntaxe d'initialisation "Vertex AI" :
us-central1
Cependant, tous les modèles ne sont pas compatibles avec ces emplacements par défaut. Cela signifie que, selon le modèle, il peut être nécessaire de définir explicitement un emplacement spécifique lors de l'initialisation.
Modèles Gemini en preview et expérimentaux : disponibles uniquement dans l'emplacement
global.Modèles stables Gemini 4.x et Gemini 3.x : disponibles dans l'emplacement
globalet souvent dans les emplacementsuseteu.Modèles Gemini Live API 2.5 : disponibles dans de nombreux emplacements, mais pas dans
global. (Notez que les modèles Gemini 2.5 à usage général ont été arrêtés pour Agent Platform Gemini API (formerly Vertex AI).)
- Lorsque vous utilisez la syntaxe d'initialisation "Agent Platform" :
Découvrez comment spécifier l'emplacement d'accès au modèle (y compris des extraits de code).
Erreurs 429 : "You exceeded your current quota, please check your plan and billing details" ou "Resource exhausted, please try again later."
Plusieurs raisons peuvent expliquer ce type d'erreur.
Vous dépassez votre quota ou le modèle auquel vous accédez est surchargé par les requêtes d'autres personnes.
La mesure à prendre dépend de l'utilisation de Gemini Developer API ou de Agent Platform Gemini API (formerly Vertex AI). Pour en savoir plus sur les quotas et sur la façon de demander des quotas supplémentaires, consultez Limites de débit et quotas.
Si vous utilisez Agent Platform Gemini API (formerly Vertex AI), la documentation Google Cloud fournit des informations supplémentaires et des conseils pour le code d'erreur 429.
Vous essayez d'utiliser un modèle ou une fonctionnalité qui nécessite la facturation, mais votre projet Firebase est associé au forfait Spark.
Si vous utilisez Gemini Developer API, vous pouvez bénéficier d'un accès limité à certains modèles et d'un accès à de nombreuses fonctionnalités de base dans le cadre du "niveau sans frais" de Gemini Developer API. Ce niveau vous permet de commencer sans avoir à fournir de mode de paiement. Vous n'avez donc pas besoin de passer au forfait Blaze avec paiement à l'usage pour votre projet Firebase.
Certains modèles ne sont pas disponibles dans le "niveau sans frais" de Gemini Developer API et nécessitent le"niveau payant ", ce qui signifie que votre projet doit être associé au forfait Blaze avec paiement à l'usage. Par exemple, les modèles suivants nécessitent presque toujours la facturation :
- La plupart des modèles en preview et expérimentaux
- Modèles de génération de contenus multimédias (comme les modèles Gemini Nano Banana)
Certains modèles proposent des fonctionnalités de base dans le Gemini Developer API "niveau sans frais", mais nécessitent le "niveau payant" pour utiliser des fonctionnalités plus avancées. Exemple :
- Lorsque vous utilisez la plupart des modèles Gemini 3.x, l'ancrage avec
Google Search ouGoogle Maps nécessite la facturation.
- Lorsque vous utilisez la plupart des modèles Gemini 3.x, l'ancrage avec
Découvrez les forfaits Firebase et le Gemini Developer API.
Pour en savoir plus, consultez la documentation sur les tarifsGemini Developer API et les questions fréquentes sur la facturation.