Interactions API : notre interface principale pour les modèles et agents Gemini

Nous annonçons aujourd'hui que l'API Interactions est désormais en disponibilité générale et constitue notre API principale pour interagir avec les modèles et agents Gemini. Nous avions lancé sa version bêta publique en décembre 2025, et elle est rapidement devenue la méthode préférée des développeurs pour créer des applications avec Gemini.

Avec cette version GA, l'API dispose désormais d'un schéma stable et nous avons également ajouté de nouvelles capacités majeures demandées par les développeurs, notamment les Managed Agents, l'exécution en arrière-plan, Gemini Omni (bientôt) et bien plus encore. Toute notre documentation utilise désormais par défaut l'API Interactions et nous travaillons avec des partenaires de l'écosystème pour en faire l'interface par défaut des SDK et bibliothèques tiers.

La manière la plus simple de créer avec Gemini

Que vous appeliez un modèle ou exécutiez un agent, l'API Interactions vous permet de le faire en quelques lignes de code. Transmettez un ID de modèle pour l'inférence ou un ID d'agent pour les tâches autonomes, et définissez background=True pour toute tâche longue.

1from google import genai
2
3client = genai.Client()
4
5# Talk to a model
6interaction = client.interactions.create(
7    model="gemini-3.5-flash",
8    input="Explain quantum entanglement simply.",
9)
10
11# Run an agent
12interaction = client.interactions.create(
13    agent="antigravity-preview-05-2026",
14    input="Plot the growth of solar energy generation globally and make some slides in HTML.",
15    environment="remote",
16)

Principales mises à jour depuis décembre

• Managed Agents: Un seul appel API provisionne un sandbox Linux distant où un agent peut raisonner, exécuter du code, naviguer sur le web et gérer des fichiers. L'agent Antigravity est fourni par défaut, et vous pouvez définir vos propres agents personnalisés avec des instructions, des compétences et des sources de données.
• Background execution: Définissez background=True sur n'importe quel appel. Le serveur exécute l'interaction de manière asynchrone.
• Améliorations des outils: Combinez des outils intégrés, comme Google Search, Google Maps avec vos propres fonctions en une seule requête. Les résultats des outils peuvent désormais renvoyer des images accompagnées de texte.
• Deep Research amélioré : Deux nouvelles versions d'agent (vitesse vs. profondeur), planification collaborative, graphiques et infographies natifs, et ancrage multimodal avec images, PDF et audio.
• Génération de contenu : Génération d'images avec Nano Banana 2 et ancrage Google Image Search, musique avec Lyria 3, et parole expressive avec synthèse vocale multi-locuteur.
• De Roles à Steps: Schéma simplifié où chaque action (user_input, thought, function_call, model_output, etc.) est une étape typée distincte, remplaçant l'ancienne structure de rôles.
• Optimisations des coûts et du développement : Les niveaux Flex et Priority vous permettent d'optimiser le coût ou la latence (Flex offre une réduction de 50 % des coûts). Les erreurs pointent désormais précisément vers le champ concerné. Les interactions passées sont récupérables avec une rétention de 55 jours dans le niveau payant.

Le nouveau standard de développement

L'API Interactions est désormais l'interface par défaut de Google AI Studio, de l'API Gemini et de toute notre documentation, qui comprend un bouton pour basculer les extraits vers l'ancien format. Nous vous recommandons d'utiliser l'API Interactions pour tous les nouveaux projets et applications.

Bien que l'ancienne API generateContent reste entièrement prise en charge et continuera à recevoir de nouveaux modèles Gemini de la gamme principale dans un avenir prévisible, nous prévoyons que les capacités de pointe pour les modèles et agents à longue durée d'exécution seront de plus en plus réservées à l'API Interactions. En effet, elle a été conçue dès le départ pour les flux de travail agentiques avec état. Nous avons publié un guide de migration pour vous aider à effectuer la transition à votre rythme.

Un écosystème orienté agents

La plupart des développeurs utilisent désormais des agents de codage (comme Antigravity) pour créer des applications. Pour faciliter la mise à jour des agents avec les derniers modèles d'API, nous avons créé la compétence gemini-interactions-api. Elle injecte dans le contexte de votre agent des modèles de bonnes pratiques pour le développement avec l'API Interactions (streaming, appel de fonctions, sortie structurée, Deep Research, etc.).

1npx skills add google-gemini/gemini-skills --skill gemini-interactions-api

Pour commencer

L'API Interactions est disponible via les SDK Python et JavaScript. Si vous créez déjà avec l'un de nos partenaires pris en charge, LiteLLM, Eigent ou Agno, vous pouvez dès aujourd'hui utiliser leurs intégrations de l'API Interactions.

Récupérez votre clé API depuis Google AI Studio et suivez la documentation de l'API Interactions pour commencer. Si vous migrez depuis generateContent, notre guide de migration fait correspondre chaque champ au nouveau schéma. Vous pouvez également consulter la spécification OpenAPI complète.

L'API Interactions a été construite sur la base des retours des développeurs, et cette priorité ne changera pas avec la disponibilité générale. Dites-nous ce dont vous avez besoin sur le forum développeur.