API Interactions

L'API Interactions est le meilleur moyen de créer avec les modèles et les agents Gemini. Depuis juin 2026, elle est disponible pour tous et recommandée pour tous les nouveaux projets. Bien qu'elle soit désormais considérée comme une API héritée, l'API d'origine generateContent reste entièrement compatible.

Pourquoi utiliser l'API Interactions ?

  • Interface universelle pour toutes les applications : conçue comme l'interface standard pour tous les cas d'utilisation, y compris la génération de texte en une seule étape, la compréhension multimodale, les sorties structurées, l'orchestration d'outils et les workflows d'agent.
  • Une seule API pour les modèles et les agents : un point de terminaison et un modèle unifiés pour appeler directement les modèles Gemini standards, ainsi que des agents spécialisés (tels que Deep Research et les agents gérés personnalisés).
  • Nouvelles fonctionnalités prêtes à l'emploi : fonctionnalités telles que l'état de conversation côté serveur facultatif à l'aide de previous_interaction_id, les étapes d'exécution observables pour le débogage et le rendu de l'interface utilisateur, et l'exécution en arrière-plan pour les tâches de longue durée à l'aide de background=true.
  • Coût inférieur avec des taux de succès de cache plus élevés : lorsque vous utilisez des conversations multitours, la gestion de l'état côté serveur facultative permet une mise en cache plus efficace du contexte entre les tours, ce qui réduit les coûts liés aux jetons.
  • Lancement de nouvelles fonctionnalités : à l'avenir, tous les nouveaux modèles, fonctionnalités multimodales fonctionnalités, outils et fonctionnalités d'agent seront lancés sur l'API Interactions.

Par défaut, l'API Interactions stocke les requêtes afin que vous puissiez exploiter les fonctionnalités de gestion de l'état côté serveur à l'aide de previous_interaction_id. Vous pouvez activer le comportement sans état en définissant store=false. Pour en savoir plus, consultez la section Conservation des données pour détails.

Premiers pas

  • Configurer votre agent de codage : connectez-vous au MCP Gemini Docs et installez la compétence gemini-interactions-api pour donner à votre assistant un accès direct aux dernières documentations pour les développeurs et aux bonnes pratiques. Pour obtenir des instructions détaillées, consultez le