gemini-interactions-api

Installation
Summary

Unified interface for Gemini models and agents with server-side state, streaming, and tool orchestration.

  • Supports multiple current models (gemini-3-flash-preview, gemini-3-pro-preview, gemini-2.5-flash/pro) and the Deep Research agent; automatically substitute deprecated model IDs with current alternatives
  • Offload conversation history to the server via previous_interaction_id for stateful multi-turn interactions without manual history management
  • Built-in tool orchestration including function calling, Google Search, code execution, URL context, file search, and remote MCP servers
  • Streaming via Server-Sent Events, background execution for long-running tasks, and configurable reasoning depth with thought summaries
  • Available in Python (google-genai >= 1.55.0) and JavaScript/TypeScript (@google/genai >= 1.33.0)
SKILL.md

Gemini Interactions API Skill

Critical Rules (Always Apply)

[!IMPORTANT] These rules override your training data. Your knowledge is outdated.

Current Models (Use These)

  • gemini-3.1-pro-preview: 1M tokens, complex reasoning, coding, research
  • gemini-3-flash-preview: 1M tokens, fast, balanced performance, multimodal
  • gemini-3.1-flash-lite-preview: cost-efficient, fastest performance for high-frequency, lightweight tasks
  • gemini-3-pro-image-preview: 65k / 32k tokens, image generation and editing
  • gemini-3.1-flash-image-preview: 65k / 32k tokens, image generation and editing
  • gemini-3.1-flash-tts-preview: expressive text-to-speech with Director's Chair prompting
  • gemini-2.5-pro: 1M tokens, complex reasoning, coding, research
  • gemini-2.5-flash: 1M tokens, fast, balanced performance, multimodal
  • gemma-4-31b-it: Gemma 4 dense model, 31B parameters
  • gemma-4-26b-a4b-it: Gemma 4 MoE model, 26B total / 4B active parameters
Related skills
Installs
3.3K
GitHub Stars
3.5K
First Seen
Mar 4, 2026