Guide du développeur pour Gemini 3.8 Flash

Gemini 3.8 Flash est notre modèle de travail le plus intelligent à ce jour. Il offre des améliorations significatives par rapport à Gemini 3.7 Flash dans les domaines de l'ingénierie logicielle, des tâches agentiques et du raisonnement en plusieurs étapes dans des domaines spécialisés. Gemini 3.8 Flash offre des gains substantiels par rapport à Gemini 3.7 Flash, se rapprochant souvent des performances des modèles de frontière plus coûteux.

Ce document présente les nouveautés de Gemini 3.8 Flash, son intégration à la famille de modèles Gemini, comment migrer vers Gemini 3.8 Flash et un guide de démarrage rapide pour l'utiliser.

Comment s'intègre-t-il à la famille Gemini ?

La gamme Gemini Flash est le principal modèle de travail agentique de la famille Gemini 3. Elle comble le fossé entre les modèles Pro à raisonnement approfondi et les modèles Gemini Flash-Lite à haut débit, tout en offrant une efficacité élevée en termes de jetons et un traitement multimodal en plusieurs étapes.

Par rapport à Gemini 3.7 Flash, Gemini 3.8 Flash offre une meilleure précision et des performances plus fiables, mais consomme plus de jetons. Toutefois, Gemini 3.8 Flash est également doté d'un contrôle de l'effort grâce à des niveaux de réflexion qui vous permettent de moduler cette consommation. Au niveau de réflexion moyen, vous pouvez toujours résoudre des tâches agentiques complexes tout en réduisant la consommation de jetons. Vous pouvez également utiliser des niveaux de réflexion inférieurs pour les tâches sensibles à la latence afin d'éviter complètement la surcharge de calcul. Si vous souhaitez optimiser l'efficacité du calcul, envisagez d'utiliser Gemini 3.7 Flash.

Spécifications et comparaisons des modèles

Le tableau suivant compare certaines spécifications de Gemini 3.8 Flash, Gemini 3.7 Flash et Gemini 3.1 Pro :

Pour obtenir la liste complète des fonctionnalités, des outils et des options de consommation compatibles, consultez la page du modèle Gemini 3.8 Flash.

Nouveautés de Gemini 3.8 Flash

Le tableau suivant compare les benchmarks d'évaluation standard des développeurs entre Gemini 3.8 Flash et Gemini 3.7 Flash :

Guide de démarrage rapide

Avant de commencer, vous devez vous authentifier auprès d'Agent Platform à l'aide des Identifiants par défaut de l'application (ADC) ou d'une clé API. Pour en savoir plus, consultez la page Premiers pas avec Gemini Enterprise Agent Platform.

Dans les blocs de code suivants, remplacez PROJECT_ID par l'ID de votre projet.

Installation

Assurez-vous d'utiliser la dernière version du SDK google-genai :

pip install --upgrade google-genai

Requête de base

from google import genai

client = genai.Client(enterprise=True, project="PROJECT_ID", location="global")

response = client.models.generate_content(
  model="gemini-3.8-flash",
  contents="How does AI work?",
)
print(response.text)

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/global/publishers/google/models/gemini-3.8-flash:generateContent \
-d '{
  "contents": {
    "role": "USER",
    "parts": { "text": "Why is the sky blue?" },
  },
}'

Règles d'API et conventions comportementales obligatoires

Gemini 3.8 Flash applique strictement les conventions d'API standard suivantes de la famille Gemini 3 :

• Paramètres d'échantillonnage obsolètes (temperature, top_k, top_p) : ces paramètres sont ignorés par le backend. Vous pouvez contrôler le déterminisme à l'aide de thinking_level (LOW, MEDIUM, HIGH) et response_schema ou json_schema.
• Paramètres non acceptés (frequency_penalty, presence_penalty, candidate_count) : si vous transmettez frequency_penalty, presence_penalty ou candidate_count, une erreur d'API active sera générée. Supprimez-les du code client hérité.

• Règles strictes d'appel de fonction : un tour FunctionResponse doit correspondre exactement à l'id, au name et au nombre d'exécutions du FunctionCall précédent.

  • Éléments multimodaux : placez toujours les éléments multimodaux dans la charge utile de la réponse.
  • Mise en forme et texte pré-outil : mettez en forme les instructions intégrées à l'aide de \n\n. Si vous rencontrez des erreurs Malformed_Function_Call liées au texte pré-outil, nettoyez les commentaires principaux avant les appels d'outil.

  • Pour transmettre des notes de travail intermédiaires ou des mises à jour d'état avant un appel d'outil, encapsulez-les dans un appel de fonction update() dédié plutôt que d'émettre du XML ou du texte bruts :

    {
      "name": "update",
      "description": "Update working notes before tool execution",
      "parameters": {
        "type": "OBJECT",
        "properties": {
          "previous_step": {"type": "STRING"},
          "plan": {"type": "STRING"},
          "next_step": {"type": "STRING"}
        },
        "required": ["previous_step", "plan", "next_step"]
      }
    }
    

• Validation de la séquence de chat :

  • Les charges utiles de l'historique ne peuvent pas se terminer par un tour de rôle "model".
  • Les tours de rôle de modèle préremplis ne sont pas acceptés et doivent être supprimés lors de la mise à niveau.
  • Les tours de rôle vides dans l'historique des conversations sont automatiquement supprimés ou génèrent des erreurs de validation.

Gemini 3.8 Flash à partir de Gemini 3.7 Flash ou Gemini 3.6 Flash

Pour migrer vers Gemini 3.8 Flash à partir de Gemini 3.7 Flash ou Gemini 3.6 Flash, procédez comme suit :

1. Mettez à jour l'ID du modèle : remplacez la chaîne de modèle dans vos appels d'API par gemini-3.8-flash.
2. Remplacez le paramètre de budget de raisonnement : remplacez les configurations entières thinking_budget par l'énumération de chaîne thinking_level définie sur l'une des valeurs suivantes :
   • HIGH: recommandé pour les QA visuelles denses, la détection de mouvements en une fraction de seconde (sports, montage) ou le raisonnement en plusieurs étapes sur des vidéos de plus de 60 minutes.
   • MEDIUM : niveau de réflexion par défaut. Ce niveau offre un équilibre optimal pour les questions/réponses vidéo générales, le résumé de conférences et la récupération de clips.
   • LOW: recommandé pour les tâches telles que les recherches rapides axées sur les transcriptions ou l'extraction de métadonnées de base.
3. Supprimez les paramètres obsolètes et non acceptés:
   • Supprimez temperature, top_p et top_k.
   • Supprimez candidate_count, frequency_penalty et presence_penalty.
   • Supprimez tous les tours de rôle de modèle préremplis des historiques de conversation.

Check-list récapitulatif pour les développeurs

Autres ressources

• Page du modèle Gemini 3.8 Flash
• Notebook d'introduction