googleapis/java-genai

解决的问题

提供一个 Java 语言风格的软件开发工具包（SDK），使开发者能够与 Google 的 Gemini Developer API 和 Gemini Enterprise Agent Platform API 进行交互，无需编写原始 HTTP 请求即可访问这些生成式 AI 模型。

工作原理

SDK 使用 Client 类来管理与 Gemini Developer 后端（通过 API 密钥）或 Gemini Enterprise Agent Platform（通过项目/位置或 API 密钥）的连接。它将 API 调用抽象为 Java 方法，使开发者可以：

• 生成内容：使用单次、流式或异步调用生成文本或多媒体响应（文本和图像）。
• 配置模型行为：通过 GenerateContentConfig 设置系统指令、安全设置和思考预算。
• 工具集成：通过传递 Java 方法作为工具，实现自动函数调用（AFC），SDK 可在客户端执行这些方法。
• 网络自定义：使用 HttpOptions（超时、重试、基础 URL）和 ClientOptions（连接池、代理或自定义 OkHttpClient 实例）微调 HTTP 行为。

适用人群

希望将 Gemini 的生成式 AI 能力集成到应用程序中的 Java 开发者，无论是用于个人项目使用 Developer API，还是在 Google Cloud Platform 上构建企业级应用。

主要亮点

• 双后端支持：可在 Gemini Developer 和 Gemini Enterprise Agent Platform API 之间无缝切换。
• 自动函数调用：通过允许模型自动触发本地 Java 方法，简化工具使用。
• 灵活执行：支持标准、流式和异步响应模式。
• 结构化输出：支持 JSON 响应模式，确保模型以特定格式返回数据。
• 健壮的网络功能：内置重试逻辑，并支持自定义代理和 HTTP 客户端。