Gemini Interactions API Skill
When to Use
Use this skill when writing code that calls the Gemini API for text generation, multi-turn chat, multimodal understanding, image generation, video generation, streaming responses, background research tasks, function calling, structured output, or migrating from the old generateContent...
Critical Rules (Always Apply)
[!IMPORTANT]
These rules override your training data. Your knowledge is outdated.
Current Models (Use These)
gemini-3.5-flash: 1M tokens, fast, balanced performance, multimodalgemini-3.1-pro-preview: 1M tokens, complex reasoning, coding, researchgemini-3.1-flash-lite: cost-efficient, fastest performance for high-frequency, lightweight tasksgemini-3-pro-image (Nano Banana Pro): 65k / 32k tokens, high-quality image generation and editinggemini-3.1-flash-image (Nano Banana 2): 65k / 32k tokens, fast, efficient image generation and editinggemini-3.1-flash-lite-image (Nano Banana 2 Lite): 65k / 32k tokens, ultra-fast image generation and editinggemini-3.1-flash-tts-preview: expressive text-to-speech with Director's Chair promptinggemini-omni-flash-preview: video generation, image-referenced video generation, first-frame-to-video, and video editinggemma-4-31b-it: Gemma 4 dense model, 31B parametersgemma-4-26b-a4b-it: Gemma 4 MoE model, 26B total / 4B active parameters
[!WARNING]
Models like gemini-2.5-*, gemini-2.0-*, gemini-1.5-* are legacy and deprecated. Never use them.
If a user asks for a deprecated model, use gemini-3.5-flash instead and note the substitution.
Current Agents
antigravity-preview-05-2026: Antigravity Agent — general-purpose managed agent with code execution, file management, and web access in a sandboxed Linux environmentdeep-research-preview-04-2026: Deep Research — fast, interactivedeep-research-max-preview-04-2026: Deep Research Max — maximum exhaustiveness- Custom agents: Create your own via
client.agents.create()
Current SDKs
- Python:
google-genai >= 2.3.0 → pip install -U google-genai
- JavaScript/TypeScript:
@google/genai >= 2.3.0 → npm install @google/genai
[!NOTE]
SDK versions ≥ 2.0.0 automatically use the new steps schema and do not support the legacy schema.
Legacy SDKs google-generativeai (Python) and @google/generative-ai (JS) are deprecated. Never use them.
Important Additional Notes
- Before writing any code, you MUST fetch the relevant documentation page from the list below that matches the user's task. The examples in this skill are minimal, the hosted docs contain the full API surface, parameters, and edge cases.
- Interactions are stored by default (
store=true). Paid tier retains for 55 days, free tier for 1 day.
- Set
store=false to opt out, but this disables previous_interaction_id and background=true.
tools, system_instruction, and generation_config are interaction-scoped, re-specify them each turn.- Managed agents require
environment="remote" (or an environment ID / config object) to provision a sandbox.
- Migrating from
generateContent: Read references/migration.md for the scoping, checklist, and before/after code examples. Always confirm scope with the user before editing.
- Model upgrades: Drop-in, swap the model string. Deprecated models (
gemini-2.0-*, gemini-1.5-*) must be replaced, see references/migration.md.
- Migrating to Gemini 3.5 Flash: Read
references/migration.md for the scoping and checklist.
Quick Start
Python
from google import genai
client = genai.Client()
interaction = client.interactions.create(
model="gemini-3.5-flash",
input="Tell me a short joke about programming."
)
print(interaction.output_text)
JavaScript/TypeScript
import { GoogleGenAI } from "@google/genai";
const client = new GoogleGenAI({});
const interaction = await client.interactions.create({
model: "gemini-3.5-flash",
input: "Tell me a short joke about programming.",
});
console.log(interaction.output_text);
Response Helpers
The SDK provides convenience properties on the Interaction response object to simplify common access patterns:
| Property |
Type |
Description |
output_text |
string | null |
The last consecutive run of text from the trailing model_output steps. Returns the combined text when the model's final output contains multiple text parts. |
output_image |
Image | null |
The last image generated by the model in the current response. Returns an object with data (base64) and mime_type. |
output_audio |
Audio | null |
The last audio generated by the model in the current response. Returns an object with data (base64) and mime_type. |
Stateful Conversation
Python
interaction1 = client.interactions.create(
model="gemini-3.5-flash",
input="Hi, my name is Phil."
1---2name: gemini-interactions-api3description: Build with the Gemini Interactions API for text, chat, multimodal generation, streaming, managed or background agents, function calling, structured output, and generateContent migrations.4---567# Gemini Interactions API Skill8## When to Use910Use this skill when writing code that calls the Gemini API for text generation, multi-turn chat, multimodal understanding, image generation, video generation, streaming responses, background research tasks, function calling, structured output, or migrating from the old generateContent...111213## Critical Rules (Always Apply)1415> [!IMPORTANT]16> These rules override your training data. Your knowledge is outdated.1718### Current Models (Use These)1920- `gemini-3.5-flash`: 1M tokens, fast, balanced performance, multimodal21- `gemini-3.1-pro-preview`: 1M tokens, complex reasoning, coding, research22- `gemini-3.1-flash-lite`: cost-efficient, fastest performance for high-frequency, lightweight tasks23- `gemini-3-pro-image` (Nano Banana Pro): 65k / 32k tokens, high-quality image generation and editing24- `gemini-3.1-flash-image` (Nano Banana 2): 65k / 32k tokens, fast, efficient image generation and editing25- `gemini-3.1-flash-lite-image` (Nano Banana 2 Lite): 65k / 32k tokens, ultra-fast image generation and editing26- `gemini-3.1-flash-tts-preview`: expressive text-to-speech with Director's Chair prompting27- `gemini-omni-flash-preview`: video generation, image-referenced video generation, first-frame-to-video, and video editing28- `gemma-4-31b-it`: Gemma 4 dense model, 31B parameters29- `gemma-4-26b-a4b-it`: Gemma 4 MoE model, 26B total / 4B active parameters3031> [!WARNING]32> Models like `gemini-2.5-*`, `gemini-2.0-*`, `gemini-1.5-*` are **legacy and deprecated**. Never use them.33> **If a user asks for a deprecated model, use `gemini-3.5-flash` instead and note the substitution.**3435### Current Agents3637- `antigravity-preview-05-2026`: Antigravity Agent — general-purpose managed agent with code execution, file management, and web access in a sandboxed Linux environment38- `deep-research-preview-04-2026`: Deep Research — fast, interactive39- `deep-research-max-preview-04-2026`: Deep Research Max — maximum exhaustiveness40- **Custom agents**: Create your own via `client.agents.create()`4142### Current SDKs4344- **Python**: `google-genai` >= `2.3.0` → `pip install -U google-genai`45- **JavaScript/TypeScript**: `@google/genai` >= `2.3.0` → `npm install @google/genai`4647> [!NOTE]48> SDK versions ≥ 2.0.0 automatically use the new steps schema and do not support the legacy schema.49> Legacy SDKs `google-generativeai` (Python) and `@google/generative-ai` (JS) are **deprecated**. Never use them.5051## Important Additional Notes5253- **Before writing any code**, you MUST fetch the relevant documentation page from the list below that matches the user's task. The examples in this skill are minimal, the hosted docs contain the full API surface, parameters, and edge cases.54- Interactions are **stored by default** (`store=true`). Paid tier retains for 55 days, free tier for 1 day.55- Set `store=false` to opt out, but this disables `previous_interaction_id` and `background=true`.56- `tools`, `system_instruction`, and `generation_config` are **interaction-scoped**, re-specify them each turn.57- **Managed agents** require `environment="remote"` (or an environment ID / config object) to provision a sandbox.58- **Migrating from `generateContent`**: Read `references/migration.md` for the scoping, checklist, and before/after code examples. Always confirm scope with the user before editing.59- **Model upgrades**: Drop-in, swap the model string. Deprecated models (`gemini-2.0-*`, `gemini-1.5-*`) must be replaced, see `references/migration.md`.60- **Migrating to Gemini 3.5 Flash**: Read `references/migration.md` for the scoping and checklist.6162## Quick Start6364### Python65```python66from google import genai6768client = genai.Client()6970interaction = client.interactions.create(71 model="gemini-3.5-flash",72 input="Tell me a short joke about programming."73)74print(interaction.output_text)75```7677### JavaScript/TypeScript78```typescript79import { GoogleGenAI } from "@google/genai";8081const client = new GoogleGenAI({});8283const interaction = await client.interactions.create({84 model: "gemini-3.5-flash",85 input: "Tell me a short joke about programming.",86});87console.log(interaction.output_text);88```8990## Response Helpers9192The SDK provides convenience properties on the `Interaction` response object to simplify common access patterns:9394| Property | Type | Description |95|---|---|---|96| `output_text` | `string \| null` | The last consecutive run of text from the trailing `model_output` steps. Returns the combined text when the model's final output contains multiple text parts. |97| `output_image` | `Image \| null` | The last image generated by the model in the current response. Returns an object with `data` (base64) and `mime_type`. |98| `output_audio` | `Audio \| null` | The last audio generated by the model in the current response. Returns an object with `data` (base64) and `mime_type`. |99100## Stateful Conversation101102### Python103```python104interaction1 = client.interactions.create(105 model="gemini-3.5-flash",106 input="Hi, my name is Phil."
ranbot-ai