generative-ai-swift

项目简介: Google AI Swift SDK

Google AI Swift SDK 是一个为 Swift 开发者设计的工具，旨在简化使用 Gemini API 的过程。Gemini API 由 Google DeepMind 开发，允许开发者访问强大的 Gemini 模型。这些模型的特别之处在于其多模态特性，能够无缝处理文本、图像和代码。

注意事项

需要注意的是，Google AI Swift SDK 目前仅适用于原型开发。如果开发者计划启用计费功能，我们强烈建议在后端使用 SDK 来访问 Google AI Gemini API，以避免潜在的 API 密钥泄露风险。

如何开始使用 Gemini API

要开始使用 Gemini API，可以按照以下步骤进行：

1. 登陆 Google AI Studio。
2. 用 Google 账号登录。
3. 创建一个 API 密钥（请注意，部分地区如欧洲不提供免费使用层）。
4. 克隆该项目的代码库：
   git clone https://github.com/google/generative-ai-swift
5. 打开并构建示例应用，该应用位于项目仓库的 Examples 文件夹中。
6. 运行应用以确保生成一个空的 GenerativeAI-Info.plist 文件。
7. 将您的 API 密钥粘贴到 GenerativeAI-Info.plist 文件中的 API_KEY 属性中。
8. 再次运行应用。
9. 如需详细说明，请参考 Google AI 文档中的 Swift SDK 教程。

使用示例

要在 Xcode 项目中使用 generative-ai-swift，可以通过 Swift 包管理器添加该包。然后，开发者只需导入 GoogleGenerativeAI 模块并初始化模型，示例如下：

import GoogleGenerativeAI

let model = GenerativeModel(name: "gemini-1.5-flash-latest", apiKey: "YOUR_API_KEY")
let cookieImage = UIImage(...)
let prompt = "Do these look store-bought or homemade?"

let response = try await model.generateContent(prompt, cookieImage)

这个简单的例子展示了如何添加 API 密钥和包，初始化模型，并做出 API 请求去访问这些模型。

其他功能和工具

Google AI Swift SDK 还包括一系列其他功能，如日志记录以及命令行工具，以便开发者通过 Xcode 或命令行实验性地发起请求。此外，详细的文档可在 Gemini API Cookbook 或 Google AI 官方网站上找到。

迁移与贡献

如果开发者之前使用的是已停用的 PaLM SDK for Swift，建议迁移到 Gemini API，并更新项目中的 generative-ai-swift 依赖至版本 0.4.0 或更高。有关迁移的更多信息，可以参考相关的迁移指南。如果开发者希望为 Google AI SDK for Swift 贡献力量，请查看项目中的贡献指南。

开源许可

Google AI Swift SDK 在 Apache 2.0 许可证下开源，开发者可以自由使用和修改代码。