Interactions API: Unsere primäre Schnittstelle für Gemini-Modelle und Agents

Heute geben wir bekannt, dass die Interactions API die allgemeine Verfügbarkeit erreicht hat und jetzt unsere primäre API für die Interaktion mit Gemini-Modellen und -Agenten ist. Wir haben die öffentliche Beta im Dezember 2025 gestartet, und sie hat sich schnell zur bevorzugten Methode der Entwickler entwickelt, um Anwendungen mit Gemini zu erstellen.

Mit dieser GA-Veröffentlichung hat die API jetzt ein stabiles Schema, und wir haben auch wichtige neue Funktionen hinzugefügt, die sich Entwickler gewünscht haben, darunter Managed Agents, Hintergrundausführung, Gemini Omni (in Kürze) und mehr. Die gesamte Dokumentation verwendet jetzt standardmäßig die Interactions API, und wir arbeiten mit Partnern im Ökosystem zusammen, um sie zur Standardschnittstelle für SDKs und Bibliotheken von Drittanbietern zu machen.

Der einfachste Weg, mit Gemini zu bauen

Ob Sie ein Modell aufrufen oder einen Agenten ausführen – die Interactions API bringt Sie mit wenigen Codezeilen ans Ziel. Übergeben Sie eine Modell-ID für die Inferenz oder eine Agenten-ID für autonome Aufgaben und setzen Sie background=True für alles, was länger läuft.

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)

Wichtige Aktualisierungen seit Dezember

• Managed Agents: Ein einziger API-Aufruf stellt eine entfernte Linux-Sandbox bereit, in der ein Agent denken, Code ausführen, im Internet surfen und Dateien verwalten kann. Der Antigravity-Agent wird standardmäßig ausgeliefert, und Sie können eigene benutzerdefinierte Agenten mit Anweisungen, Fähigkeiten und Datenquellen definieren.
• Hintergrundausführung: Setzen Sie bei jedem Aufruf background=True. Der Server führt die Interaktion asynchron aus.
• Tool-Verbesserungen: Mischen Sie integrierte Tools wie die Google-Suche, Google Maps mit Ihren eigenen Funktionen in einer Anfrage. Tool-Ergebnisse können jetzt Bilder neben Text zurückgeben.
• Deep Research -Upgrades: Zwei neue Agentenversionen (Geschwindigkeit vs. Tiefe), kollaborative Planung, native Diagramme und Infografiken sowie multimodale Verankerung mit Bildern, PDFs und Audio.
• Mediengenerierung: Bildgenerierung mit Nano Banana 2 und Google Image Search-Verankerung, Musik mit Lyria 3 und ausdrucksstarke Sprache mit mehrsprachigem TTS.
• Von Rollen zu Schritten: Vereinfachtes Schema, bei dem jede Aktion (user_input, thought, function_call, model_output, etc.) ein eigenständiger typisierter Schritt ist, der die alte Rollenstruktur ersetzt.
• Kosten- und Entwickleroptimierungen: Flex- und Priority-Tarife ermöglichen Ihnen die Optimierung auf Kosten oder Latenz (Flex bietet 50% Kostenreduzierung). Fehler geben jetzt das genaue Feld an. Vergangene Interaktionen sind abrufbar mit 55-tägiger Aufbewahrung im kostenpflichtigen Tarif.

Der neue Standard für die Entwicklung

Die Interactions API ist jetzt der Standard für Google AI Studio, die Gemini API und die gesamte Dokumentation, die einen Umschalter enthält, um Code-Snippets wieder in das Legacy-Format zu versetzen. Wir empfehlen die Verwendung der Interactions API für alle neuen Projekte und Anwendungen.

Während die Legacy-API generateContent weiterhin vollständig unterstützt wird und auch in absehbarer Zukunft neue Hauptlinien-Gemini-Modelle erhalten wird, erwarten wir, dass Grenzfunktionen für langlebige Modelle und Agenten zunehmend ausschließlich auf der Interactions API landen werden. Dies liegt daran, dass sie von Grund auf für zustandsbehaftete, agentische Workflows konzipiert wurde. Wir haben einen Migrationsleitfaden veröffentlicht, der Ihnen hilft, in Ihrem eigenen Tempo zu wechseln.

Ein agentenorientiertes Ökosystem

Die meisten Entwickler verwenden jetzt Code-Agenten (wie Antigravity), um Anwendungen zu erstellen. Um es Agenten zu erleichtern, mit den neuesten API-Mustern auf dem neuesten Stand zu bleiben, haben wir das gemini-interactions-api Skill entwickelt. Es fügt Best-Practice-Muster für die Entwicklung mit der Interactions API in den Kontext Ihres Agenten ein (Streaming, Funktionsaufruf, strukturierte Ausgabe, Deep Research und mehr).

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

Erste Schritte

Die Interactions API ist über die Python- und JavaScript- SDKs verfügbar. Wenn Sie bereits mit einem unserer unterstützten Partner wie LiteLLM, Eigent oder Agno bauen, können Sie noch heute mit deren Interactions-API-Integrationen beginnen.

Holen Sie sich Ihren API-Schlüssel von Google AI Studio und folgen Sie der Dokumentation zur Interactions API, um loszulegen. Wenn Sie von generateContent migrieren, ordnet unser Migrationsleitfaden jedes Feld dem neuen Schema zu. Sie können auch die vollständige OpenAPI-Spezifikation einsehen.

Die Interactions API wurde auf der Grundlage von Entwicklerfeedback entwickelt, und dieser Fokus wird sich mit der allgemeinen Verfügbarkeit nicht ändern. Teilen Sie uns mit, was Sie brauchen, im Entwicklerforum.