Google Gen AI Java SDK

它是什么 – 一个官方 Java 客户端库，允许你从 Java 代码调用 Google 的 Gemini 大型语言模型 API（公共 Gemini 开发者 API 和 Gemini Enterprise Agent Platform）。

主要功能

• 简单的 Client 构建器，用于配置 API 密钥、GCP 项目/位置或“企业”模式。
• 支持主要的 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 行为或启用工具/安全设置。

适用对象 – 希望将 Gemini LLM 功能（文本生成、多模态图像描述、函数调用或结构化 JSON 输出）集成到后端服务、桌面应用或 Android 风格 JVM 项目中，而无需处理原始 HTTP 调用的 Java 开发人员。

限制 / 即将进行的更改

• 在下一个主要版本中，AFC 将从 Models.generate_content 移至 Chats 模块。
• 从 SDK 2.0.0 开始，Java 17 成为最低支持版本；如果你需要旧版 JDK，请固定版本。

了解更多 – 仓库的 README 链接到 Maven 徽章、Javadoc 和 examples/ 下每个功能的示例代码。