Gemini API 快速入門導覽課程

本快速入門導覽課程說明如何使用所選 SDK 開始使用 Gemini API。


在 Google AI 中查看 試用 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 工作室中建立。

從 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 參考資料中的指南。