Gemini API 快速入门

本快速入门介绍了如何使用您选择的 SDK 开始使用 Gemini API。


在 Google 上查看 试用 Colab 笔记本 在 GitHub 上查看笔记本

前提条件

本快速入门假定您熟悉使用 Python 构建应用。

如需完成本快速入门,请确保您的开发环境满足以下要求:

  • Python 3.9 及更高版本

安装 Google AI SDK

Gemini API 的 Python SDK 包含在 google-generativeai 软件包中。使用 pip 安装依赖项:

pip install -q -U google-generativeai

设置身份验证

如本部分所述,向 Gemini API 进行身份验证的最简单方法是配置 API 密钥。如果您需要更严格的访问权限控制,可以改为使用 OAuth

如果您还没有 API 密钥,请在 Google AI Studio 中创建一个。

从 Google AI Studio 获取 API 密钥

然后,配置您的密钥。

强烈建议您不要将 API 密钥签入版本控制系统,而是将其分配为环境变量:

export API_KEY=<YOUR_API_KEY>

导入库

导入并配置 Google 生成式 AI 库。

import google.generativeai as genai
import os

genai.configure(api_key=os.environ["API_KEY"])

发出您的首个请求

使用 generateContent 方法生成文本。

model = genai.GenerativeModel("gemini-1.5-flash")
response = model.generate_content("Write a story about a magic backpack.")
print(response.text)

后续步骤

现在,您已设置好向 Gemini API 发出请求,接下来就可以使用 Gemini API 的全部功能来构建应用和工作流。如需开始使用 Gemini API 功能,请参阅以下指南:

如需详细了解 Gemini API 方法和请求参数,请参阅 API 参考文档中的指南。