Migrer vers l'API Interactions

Ce guide vous aide à migrer de l'API generateContent vers l'API Interactions.

L'API Interactions est le moyen le plus simple et le plus efficace de créer des solutions avec les modèles et les agents Gemini. Bien que generateContent reste entièrement compatible, nous recommandons l'API Interactions pour tous les nouveaux développements.

Pourquoi migrer ?

L'API Interactions est le moyen le plus simple et le plus efficace de créer des solutions avec les modèles et les agents Gemini :

  • Gestion de l'historique côté serveur : flux multitours simplifiés via previous_interaction_id. Le serveur active l'état par défaut (store=true), mais vous pouvez choisir un comportement sans état en définissant store=false.
  • Étapes d'exécution observables : les étapes typées facilitent le débogage des flux complexes et le rendu de l'UI pour les événements intermédiaires (comme les pensées ou les widgets de recherche).
  • Utilisation d'outils et workflows d'agent : prise en charge native de l'utilisation d'outils en plusieurs étapes, de l'orchestration et des flux de raisonnement complexes via des étapes d'exécution typées.
  • Tâches de longue durée et en arrière-plan : prend en charge le déchargement des opérations gourmandes en ressources, telles que Deep Think et Deep Research, vers des processus en arrière-plan à l’aide de background=true.

Entrée/Sortie de base

Cette section explique comment migrer une simple requête de génération de texte.

Avant (generateContent)

L'API generateContent est sans état et renvoie directement la réponse. La structure de la réponse encapsule la sortie dans une liste de candidates, chacune contenant content avec une liste de parts à analyser.

Python

from google import genai

client = genai.Client()

response = client.models.generate_content(
    model="gemini-2.5-flash-lite", contents="Tell me a joke."
)
print(response.text)

JavaScript