Nano Banana : diagnostic des erreurs

Valeurs des paramètres : voir Nano Banana : texte vers image et tailles.

Partir du symptôme

400 Request contains an invalid argument

{
  "error": {
    "code": 400,
    "message": "Request contains an invalid argument.",
    "status": "INVALID_ARGUMENT"
  }
}

Cette erreur n’indique pas quel paramètre est en cause. D’après nos tests, tous les cas suivants la renvoient :

Méthode de diagnostic : retirez d’abord imageConfig et réessayez ; si la génération fonctionne, le problème vient du format ou de la résolution. Rajoutez-les ensuite un par un pour l’isoler.

Format ou résolution incorrects

Vérifiez d’abord la largeur et la hauteur réelles de l’image produite, puis reportez-vous au tableau ci-dessous :

Écriture correcte :

{
  "contents": [{ "parts": [{ "text": "..." }] }],
  "generationConfig": {
    "responseModalities": ["IMAGE"],
    "imageConfig": { "aspectRatio": "9:16", "imageSize": "2K" }
  }
}

Les deux écritures imageConfig / image_config et aspectRatio / aspect_ratio sont reconnues ; nous avons vérifié que image_config: { aspect_ratio: "9:16" } produit bien du 768×1376.

Pas d’image dans la réponse

Dans des clients comme Cherry Studio ou LobeHub, ajoutez le modèle en tant que modèle de génération d’images, et non comme modèle de chat.

410 model_deprecated

{
  "error": {
    "message": "Model 'google/gemini-3-pro-image-preview' is deprecated and no longer accepts requests; please switch to an active model",
    "type": "model_deprecated",
    "code": 410
  }
}

Les anciens ID se terminant par -preview ont été retirés ; utilisez les ID de la version stable :

Dans le chemin de l’endpoint natif, l’ID de modèle peut comporter ou non le préfixe google/ ; nos tests confirment que les deux fonctionnent.

Le résultat de l’édition n’a aucun rapport avec l’image d’origine

Pour vérifier que l’image de référence a bien été lue : sur l’endpoint natif, regardez si usageMetadata.promptTokensDetails contient un élément IMAGE ; sur l’endpoint compatible OpenAI, regardez usage.input_tokens_details.image_tokens. Nous avons mesuré 1 120 tokens pour une image de référence de 1024×1024.

Blocages de sécurité

Lorsqu’une requête est bloquée par la politique de sécurité, la réponse ne contient pas d’image et la raison figure dans finishReason ou promptFeedback.blockReason. Signification de chaque valeur (selon les définitions officielles de Google) :

Votre code ne doit pas supposer que la réponse contient toujours une image : vérifiez d’abord que candidates existe et que finishReason vaut STOP, puis lisez inlineData. Définition de chaque champ : Gemini API · FinishReason .

Délai dépassé, 504, 524

L’API est synchrone : nous avons mesuré environ 5 à 20 secondes en 1K et environ 30 secondes en 4K, davantage aux heures de pointe. Le délai par défaut courant de 60 secondes ne suffit pas.

• Réglez le délai d’attente du client sur 300 secondes ou plus.
• Vérifiez le délai des proxys intermédiaires comme Nginx, Vercel ou Cloudflare, dont la valeur par défaut n’est souvent que de 60 à 100 secondes.
• Un PNG 4K pèse environ 16 Mo et le corps de la réponse dépasse 20 Mo : vérifiez que vos proxys ne tronquent pas les réponses volumineuses.

Si le client se déconnecte avant la fin, la requête est tout de même facturée.

Autres erreurs

Lorsque vous contactez le support technique, fournissez le request_id de la réponse et le message d’erreur complet.

FAQ