generative-ai-android - Google Gemini API 的官方 Android 库

项目介绍：Google AI SDK for Android

Google AI Android SDK 是一个为 Android 开发者设计的工具，旨在简化与 Gemini API 的集成。由 Google DeepMind 开发的 Gemini 模型具备多模式能力，可以在文字、图像和代码之间无缝推理。该 SDK 是 Android 开发者快速原型开发的理想选择。

警告与注意事项

需要注意的是，Google AI SDK for Android 仅推荐用于原型开发。如果计划启用计费功能，强烈建议通过后端 SDK 来访问 Google AI Gemini API，以避免 API 密钥暴露在 Android 应用中，防止其被恶意行为者利用。

如果希望在设备上访问 Gemini（也称为 Gemini Nano），则应使用 Google AI Edge SDK for Android，该功能通过 Android AICore 实现。

Gemini API 的入门步骤

项目的代码库包含了一个示例应用程序，展示了如何使用 SDK 来访问和利用 Gemini 模型以应对各种用例。开发者可以在 Android Studio 中直接导入该示例应用，并通过执行以下步骤进行尝试：

访问 Google AI Studio。
使用 Google 帐号登录。
创建 API 密钥（注意在欧洲地区没有免费服务）。
克隆代码仓库：git clone https://github.com/google/generative-ai-android。
在仓库中的 generativeai-android-sample 文件夹下打开并构建示例应用。
将 API 密钥粘贴到 local.properties 文件的 apiKey 属性中。
运行应用程序。

更详细的操作说明可以参考 ai.google.dev 上的 Android SDK 教程。

使用示例

在 Android 项目中添加依赖：implementation("com.google.ai.client.generativeai:generativeai:<version>")。

初始化模型：

val generativeModel = GenerativeModel(
    modelName = "gemini-1.5-pro-latest",
    apiKey = BuildConfig.apiKey
)

执行提示：

val cookieImage: Bitmap = // ...
val inputContent = content() {
  image(cookieImage)
  text("Does this look store-bought or homemade?")
}

val response = generativeModel.generateContent(inputContent)
print(response.text)

SDK 快速入门指南讲解了如何将 API 密钥和 SDK 依赖添加到应用中，初始化模型，然后调用 API 访问模型。还描述了一些附加用例和功能，例如流式数据、计数令牌和控制响应等。

文档与资源

有关全面的文档，请参考 Gemini API Cookbook 或 ai.google.dev。

贡献方式

有关如何参与 Google AI 客户端 SDK for Android 的贡献，请查看项目中的 CONTRIBUTING.md。

许可信息

该代码库内容依据 Apache License, version 2.0 授权使用。