Premiers pas avec Gemini 4

Le premier modèle Gemini 4 est Gemini 4 Argon (gemini-4-argon), le modèle de frontière de Google qui excelle dans le travail approfondi sur des tâches concrètes et complexes dans des domaines tels que le codage, la finance, le droit, la cybersécurité et la science.

Ce guide vous explique comment effectuer votre première requête Gemini 4, décrit les nouveautés de Gemini 4 et explique ce qui change lorsque vous migrez depuis Gemini 3.1 Pro. Pour en savoir plus sur le modèle, consultez le guide du développeur pour Gemini 4 Argon.

Guide de démarrage rapide

Avant de commencer, vous devez vous authentifier auprès de Gemini Enterprise Agent Platform à l'aide d'une clé API ou des identifiants par défaut de l'application (ADC). Pour en savoir plus, consultez Méthodes d'authentification.

Installer le SDK Google Gen AI

Passez à la dernière version du SDK google-genai (>= 2.30.1 pour Python, @google/genai >= 2.29.1 pour JavaScript) :

pip install --upgrade "google-genai>=2.30.1"

Définir des variables d'environnement

Remplacez GOOGLE_CLOUD_PROJECT par l'ID du projet Cloud de Confiance by S3NS . Gemini 4 Argon est disponible sur le point de terminaison global et dans les emplacements multirégionaux us et eu :

export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True

Créer votre première requête

from google import genai

client = genai.Client()

response = client.models.generate_content(
    model="gemini-4-argon",
    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-4-argon:generateContent \
-d '{
  "contents": {
    "role": "USER",
    "parts": { "text": "How does AI work?" }
  }
}'

Nouveautés de Gemini 4

Limite unifiée de jetons d'entrée et de sortie

Gemini 4 Argon a une limite unifiée de 1 048 576 jetons qui inclut à la fois les jetons d'entrée et de sortie (où la sortie inclut le raisonnement, les appels de fonction et la réponse finale). La sortie peut utiliser jusqu'à 1 048 576 jetons moins vos jetons d'entrée. Par défaut, une seule requête synchrone génère jusqu'à 65 536 jetons de sortie (ou 32 768 jetons pour les requêtes HTTP directes sans streaming).

Décodages longs

Lorsqu'un seul tour nécessite plus de 65 536 (ou 32 768 pour les appels HTTP directs non diffusés en streaming) jetons de sortie (par exemple, des preuves formelles, des problèmes mathématiques ou scientifiques complexes, ou une génération de code multifichier), Gemini 4 Argon accepte les décodages longs jusqu'à 1 048 576 jetons (moins vos jetons d'entrée) sur GenerateContent (generateContent et streamGenerateContent). Avec le dernier SDK Google Gen AI (google-genai >= 2.30.1 pour Python, @google/genai >= 2.29.1 pour JavaScript), définir max_output_tokens sur une valeur supérieure à 65 536 (ou supérieure à 32 768 pour les requêtes non diffusées en streaming) suit automatiquement continuation_token dans les requêtes pour renvoyer une seule réponse ou un seul flux. Pour les appels REST directs, transmettez le continuation_token de chaque réponse CONTINUATION à la requête suivante avec la même requête.

Pour obtenir des exemples de code, connaître les exigences de version du SDK et les règles d'implémentation, consultez Long decodes in the developer's guide to Gemini 4 Argon (Décodages longs dans le guide du développeur pour Gemini 4 Argon).

Niveaux de raisonnement

Utilisez thinking_level pour contrôler le temps de réflexion du modèle avant qu'il ne réponde. Gemini 4 Argon est compatible avec LOW, MEDIUM (par défaut sur gemini-4-argon) et HIGH (par défaut sur gemini-4-argon-cyber-permissive) :

from google import genai
from google.genai import types

client = genai.Client()

response = client.models.generate_content(
    model="gemini-4-argon",
    contents="Design a lock-free ring buffer in Rust for multi-producer, single-consumer telemetry ingestion.",
    config=types.GenerateContentConfig(
        thinking_config=types.ThinkingConfig(
            thinking_level=types.ThinkingLevel.HIGH,
        ),
    ),
)
print(response.text)

Mise en cache implicite du contexte

Gemini 4 Argon est compatible avec la mise en cache implicite pour les préfixes de prompt partagés de 6 144 jetons ou plus, avec la mise en cache durable activée par défaut. Pour en bénéficier, placez le contenu statique, comme un dépôt de code ou des documents longs, au début de votre requête.

Compréhension agentique des vidéos

La compréhension agentique des vidéos est en disponibilité générale. Elle est désactivée par défaut : les vidéos mises en ligne utilisent media_processing="static". Pour l'activer, définissez media_processing sur "agentic".

Paramètres d'échantillonnage

Gemini 4 Argon ignore les valeurs personnalisées pour temperature, top_p et top_k, comme les modèles Gemini 3 récents. Pour contrôler la sortie, utilisez thinking_level et la sortie structurée (response_schema).

Migrer depuis Gemini 3.1 Pro

Nous vous recommandons de migrer de gemini-3.1-pro-preview vers gemini-4-argon. Le comportement suivant est différent dans Gemini 4 Argon :

Pour migrer :

1. Remplacez l'ID du modèle par gemini-4-argon et passez au dernier SDK Google Gen AI (google-genai >= 2.30.1 pour Python).
2. Tenez compte de la limite unifiée de 1 048 576 jetons d'entrée et de sortie, et de la limite de sortie de 65 536 jetons (ou 32 768 jetons pour les requêtes HTTP directes sans streaming) par requête (ou configurez des décodages longs pour des sorties plus volumineuses sur GenerateContent).
3. Remplacez thinking_budget et thinking_level="MINIMAL" par thinking_level défini sur LOW, MEDIUM ou HIGH.
4. Supprimez les références cached_content explicites.
5. Supprimez temperature, top_p et top_k, qui n'ont aucun effet.

Gemini 4 Argon Cyber Permissive

Gemini 4 Argon Cyber Permissive est une version de Gemini 4 Argon pour les cas d'utilisation de cybersécurité défensive, disponible via une liste d'autorisation. Pour en savoir plus sur les différences et l'accès, consultez Gemini 4 Argon Cyber Permissive.

Étapes suivantes

• Essayez le tutoriel sur le notebook Présentation de Gemini 4 Argon.
• Consultez le guide du développeur pour Gemini 4 Argon.
• Consultez la page du modèle Gemini 4 Argon pour connaître les spécifications, les fonctionnalités compatibles et les emplacements.
• En savoir plus sur le raisonnement