googleapis/python-genai

Google Gen AI Python SDK

概要 – GoogleのGemini生成AIモデル（公開版Gemini Developer APIおよびGemini Enterprise Agent Platformの両方）を呼び出すためのファーストパーティのPythonクライアントライブラリです。RESTエンドポイントを便利で型定義されたインターフェースでラップし、認証、HTTPトランスポート、およびレスポンスの解析を処理します。

主な機能

• APIキー（公開版Gemini）またはエンタープライズ資格情報（プロジェクト、ロケーション）を使用して genai.Client を作成します。
• client.models.generate_content を呼び出して、gemini-3.5-flash や gemini-2.5-flash などのGeminiモデルからテキスト、画像、またはビデオを取得します。
• 入力として、プレーンな文字列、辞書、またはより高度な google.genai.types Pydanticモデル（例: Part.from_text, Part.from_uri, Part.from_function_call）を提供できます。
• GenerateContentConfig を使用して生成を構成します（temperature、top-p/k、max tokens、safety settings、system instructions、response modalitiesなど）。
• 自動関数呼び出しを使用：Pythonのcallableをツールとして渡すとモデルがそれらを呼び出すことができます。または、明示的な関数呼び出しオブジェクトを受け取るために無効にすることもできます。
• ストリーミング、非同期呼び出し（client.aio経由）、および高速な aiohttp トランスポートオプションをサポートしています。
• プロキシ、カスタムベースURL、およびAPIバージョン選択（v1, v1alpha）の組み込み処理。
• 自動リソースクリーンアップのためのコンテキストマネージャのサポート、および明示的な close()/aclose() メソッド。
• モデルのリスト表示、ファイルのアップロード、およびセーフティ設定の設定のためのヘルパーユーティリティ。

典型的な使用例

from google import genai
from google.genai import types

client = genai.Client(api_key="YOUR_GEMINI_API_KEY")
response = client.models.generate_content(
    model="gemini-3.5-flash",
    contents=types.Part.from_text("Why is the sky blue?"),
    config=types.GenerateContentConfig(temperature=0, top_p=0.95),
)
print(response.text)

重要性 – GoogleのGemini APIの低レベルなHTTP詳細を抽象化し、型安全なリクエスト構築を提供し、関数呼び出しやセーフティコントロールなどの高度な機能を統合します。これにより、Python開発者が最先端の生成AIをアプリケーション、サービス、またはリサーチノートブックに組み込むことが容易になります。

ドキュメントとインストール

• Docs: https://googleapis.github.io/python-genai/
• Install: pip install google-genai (または uv pip install google-genai)