项目简介: 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,可以按照以下步骤进行:
- 登陆 Google AI Studio。
- 用 Google 账号登录。
- 创建一个 API 密钥(请注意,部分地区如欧洲不提供免费使用层)。
- 克隆该项目的代码库:
git clone https://github.com/google/generative-ai-swift
- 打开并构建示例应用,该应用位于项目仓库的
Examples
文件夹中。 - 运行应用以确保生成一个空的
GenerativeAI-Info.plist
文件。 - 将您的 API 密钥粘贴到
GenerativeAI-Info.plist
文件中的API_KEY
属性中。 - 再次运行应用。
- 如需详细说明,请参考 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 许可证下开源,开发者可以自由使用和修改代码。