Gemini API 的使用方式

April 21, 2025

Python

雖然不像 OpenAI API 那麼熱門，但 Gemini API 除了有不錯的回答表現，也提供給開發者更多的額度。

API 使用步驟

以下說明如何呼叫 Gemini API 產生結果：

安裝套件：

pip install -q -U google-genai

到 Google AI Studio 產生 Gemini 的 API Key。
第一次呼叫 Gemini API：

from google import genai

client = genai.Client(api_key="YOUR_API_KEY")

response = client.models.generate_content(
    model="gemini-2.0-flash", #要使用的模型
    contents="Explain how AI works in a few words" #問題內文
)
print(response.text) #回答結果

(若有需要)「結構化輸出結果」功能，可讓模型精確輸出符合欄位格式的 JSON 資料。詳細內容可參考：透過 Gemini API 產生結構化輸出內容 - Google AI for Developers。以下是 Google 提供的範例，並加上註解：

from google import genai
from pydantic import BaseModel

class Recipe(BaseModel): # 輸出的格式
  recipe_name: str
  ingredients: list[str]

client = genai.Client(api_key="GEMINI_API_KEY")
response = client.models.generate_content(
    model='gemini-2.0-flash',
    contents='List a few popular cookie recipes. Be sure to include the amounts of ingredients.',
    config={
        'response_mime_type': 'application/json', #指定為 JSON 格式
        'response_schema': list[Recipe], #指定格式 (類別)
    },
)
# 將回應當成 JSON string
print(response.text)

# 當成物件使用
my_recipes: list[Recipe] = response.parsed