Interactions API : Gemini モデルおよびエージェント向けの主要インターフェース

本日、Interactions API が一般提供（GA）に達し、Gemini モデルおよびエージェントと対話するための主要な API となったことを発表します。この API は 2025 年 12 月にパブリックベータ版としてリリースされ、すぐに開発者が Gemini でアプリケーションを構築する際に最も好まれる方法となりました。

この GA リリースにより、API は安定したスキーマを備え、Managed Agents、バックグラウンド実行、Gemini Omni（近日公開）など、開発者が求める主要な新機能も追加されました。すべてのドキュメントはデフォルトで Interactions API を使用するようになり、エコシステムパートナーと連携して、サードパーティの SDK やライブラリ全体で標準インターフェース化を進めています。

Gemini を活用する最もシンプルな方法

モデルを呼び出す場合でもエージェントを実行する場合でも、Interactions API を使用すれば数行のコードで実現できます。推論にはモデル ID を、自律タスクにはエージェント ID を渡し、長時間実行タスクには background=True を設定するだけです。

1from google import genai
2
3client = genai.Client()
4
5# モデルと対話
6interaction = client.interactions.create(
7    model="gemini-3.5-flash",
8    input="量子もつれを簡単に説明してください。",
9)
10
11# エージェントを実行
12interaction = client.interactions.create(
13    agent="antigravity-preview-05-2026",
14    input="世界の太陽光発電の成長をグラフ化し、HTML でスライドを作成してください。",
15    environment="remote",
16)

2025 年 12 月以降の主なアップデート

• Managed Agents: 1 回の API 呼び出しで、エージェントが推論、コード実行、Web ブラウジング、ファイル管理を行えるリモート Linux サンドボックスをプロビジョニングします。Antigravity エージェント がデフォルトで提供され、独自のカスタムエージェント を指示、スキル、データソースとともに定義することもできます。
• バックグラウンド実行: 任意の呼び出しで background=True を設定します。サーバーが非同期でインタラクションを実行します。
• ツールの改善: Google 検索、Google マップ などの組み込みツールと独自の関数を 1 つのリクエストで組み合わせられます。ツールの結果では、テキストに加えて画像も返せるようになりました。
• Deep Research のアップグレード: 2 つの新しいエージェントバージョン（速度重視と深さ重視）、共同計画、ネイティブのチャートとインフォグラフィックス、画像・PDF・音声によるマルチモーダルグラウンディング。
• メディア生成: Nano Banana 2 と Google 画像検索グラウンディングによる画像生成、Lyria 3 による音楽生成、マルチスピーカー TTS による表情豊かな音声合成。
• Roles から Steps へ: すべてのアクション（user_input、thought、function_call、model_output など）がそれぞれ型付きのステップとして表現されるシンプルなスキーマに移行。従来のロール構造を置き換えます。
• コストと開発者向け最適化: Flex および Priority ティア により、コストまたはレイテンシを最適化できます（Flex では 50% のコスト削減）。エラーは該当フィールドを正確に示します。過去のインタラクションは取得可能で、有料ティアでは 55 日間保持されます。

開発の新しい標準

Interactions API は、Google AI Studio、Gemini API、およびすべてのドキュメントでデフォルトになりました。ドキュメントには、スニペットをレガシー形式に切り替えるトグルも用意されています。新しいプロジェクトやアプリケーションでは、Interactions API の使用をお勧めします。

従来の generateContent API は引き続き完全にサポートされ、今後も新しいメインラインの Gemini モデルが提供されますが、長期実行モデルやエージェント向けのフロンティア機能は、今後 Interactions API にのみ実装される見込みです。これは、Interactions API がステートフルでエージェント指向のワークフロー向けにゼロから設計されているためです。移行ガイド を公開していますので、ご自身のペースで移行を進めてください。

エージェントファーストのエコシステム

現在、ほとんどの開発者はコーディングエージェント（Antigravity など）を使用してアプリケーションを構築しています。エージェントが最新の API パターンを常に把握できるように、gemini-interactions-api Skill を構築しました。これにより、Interactions API 開発のベストプラクティスパターン（ストリーミング、関数呼び出し、構造化出力、Deep Research など）がエージェントのコンテキストに注入されます。

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

はじめに

Interactions API は、Python および JavaScript の SDK を通じて利用可能です。すでにサポートされているパートナー（LiteLLM、Eigent、Agno）のいずれかで構築している場合は、これらの Interactions API 統合を今すぐ利用開始できます。

Google AI Studio から API キーを取得し、Interactions API のドキュメント に従って開始してください。generateContent から移行する場合は、移行ガイド で各フィールドと新しいスキーマの対応を確認できます。完全な OpenAPI 仕様 もご覧いただけます。

Interactions API は開発者のフィードバックに基づいて構築されており、その姿勢は一般提供後も変わりません。開発者フォーラム でご要望をお聞かせください。