Source: Gemini API Streaming Interactions Docs
Google Gemini API documentation on SSE streaming in the Interactions API using a step-based event model.
Contents
- What: official API documentation page
- Author/publisher: Google
- Date: living document; read 2026-11-14
- Original: Streaming interactions
Summary
The Interactions API (which the docs now position ahead of the legacy generateContent API) streams with stream: true / ?alt=sse. All content (text, thoughts, tool calls) flows through a uniform step-based event model.
Key claims
- Event sequence:
interaction.created→ optionalinteraction.status_update→ for each stepstep.start(with steptype, e.g.thoughtormodel_output), N ×step.delta,step.stop→interaction.completed(with usage, including cached and thought tokens) →donewith[DONE]. Failures arrive as anerrorevent withcodeandmessage(example:gateway_timeout). - Delta types include
textandthought_signature. - A non-streaming response’s
stepsarray equals the assembledstep.start→ deltas →step.stopcycles. - The older generateContent API streams via
streamGenerateContent; structured output streams as partial JSON chunks.