Guide du développeur pour Gemini 3.7 Flash

Gemini 3.7 Flash est notre modèle intelligent pour un usage quotidien destiné aux développeurs. Il représente une avancée dans le domaine de l'ingénierie logicielle et offre une expérience de développement nettement améliorée. Ce modèle apporte une meilleure intelligence pour les tâches complexes, le suivi des instructions et l'appel d'outils dans vos workflows quotidiens.

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

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

Gemini 3.7 Flash est le modèle agentique principal de la famille Gemini 3. Il 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.

Spécifications et comparaisons des modèles

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

Consultez la page du modèle 3.7 Flash pour obtenir la liste complète des fonctionnalités, des outils et des options de consommation compatibles.

Nouveautés de Gemini 3.7 Flash

Le tableau suivant compare les benchmarks d'évaluation standard des développeurs entre Gemini 3.7 Flash et 3.6 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 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.7-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.7-flash:generateContent \
-d '{
  "contents": {
    "role": "USER",
    "parts": { "text": "Why is the sky blue?" },
  },
}'

Règles d'API et conventions comportementales obligatoires

Gemini 3.7 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 compatibles (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.

  • Assets multimodaux : placez toujours les assets multimodaux dans la charge utile de la réponse.
  • Mise en forme et texte avant l'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 avant l'outil, nettoyez les commentaires principaux avant les appels d'outils.

  • 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 code 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 compatibles 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.

Migrer vers 3.7 Flash depuis 3.5 Flash ou 3.6 Flash

Pour migrer vers 3.7 Flash depuis 3.5 Flash ou 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.7-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, la synthèse 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 compatibles:
   • 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.

Checklist récapitulative pour les développeurs

Autres ressources

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