Google Gen AI Java SDK

概要 – Java コードから Google の Gemini 大規模言語モデル API（公開 Gemini Developer API および Gemini Enterprise Agent Platform）を呼び出すための公式 Java クライアントライブラリです。

主な機能

• API キー、GCP プロジェクト/ロケーション、または「エンタープライズ」モードを設定するためのシンプルな Client ビルダー。
• 主要な Gemini エンドポイントをサポート：generateContent（テキスト、マルチモーダル、ストリーミング、非同期）、トークンカウント、ビデオ生成。
• 詳細な HTTP 制御のための設定オブジェクト（HttpOptions、HttpRetryOptions、ClientOptions）。カスタム OkHttp クライアント、プロキシ、タイムアウト、リトライポリシーを含む。
• GenerateContentConfig による高度なモデルオプション：システム指示、安全設定、ツール使用（Google Search、自動関数呼び出し）、応答スキーマ、トークン制限、思考予算。
• 自動関数呼び出し（AFC）– Java 静的メソッドをモデルが呼び出せるツールとして公開。
• 低遅延または非ブロッキング使用のためのストリーミングおよび非同期 API。
• Maven アーティファクト com.google.genai:google-genai（現在 1.77.0、v2.0.0 以降 Java 17+ が必要）。

一般的な使用フロー

1. Maven 依存関係を追加します。
2. GOOGLE_API_KEY（またはエンタープライズモードのプロジェクト/ロケーション環境変数）を設定するか、Client.builder() に渡します。
3. Client インスタンスを作成します。
4. client.models.generateContent(modelName, prompt, config)（またはストリーミング/非同期バリアント）を呼び出します。
5. 必要に応じて、設定オブジェクトを使用して HTTP 動作をカスタマイズしたり、ツール/安全設定を有効にしたりします。

対象読者 – 生の HTTP 呼び出しを処理せずに、Gemini LLM 機能（テキスト生成、マルチモーダル画像説明、関数呼び出し、構造化 JSON 出力）をバックエンドサービス、デスクトップアプリ、または Android スタイルの JVM プロジェクトに統合したい Java 開発者。

制限 / 今後の変更

• 次のメジャーバージョンでは、AFC は Models.generate_content から Chats モジュールに移動します。
• SDK 2.0.0 以降、Java 17 が最小サポートバージョンになります。古い JDK が必要な場合はバージョンを固定してください。

詳細情報 – リポジトリの README には、Maven バッジ、Javadoc、および各機能の examples/ ディレクトリのサンプルコードへのリンクがあります。