您現在可以透過 Google 搜尋進行地面資訊驗證了！瞭解詳情

本頁面由 Cloud Translation API 翻譯而成。

教學課程：開始使用 Gemini API

透過 Google AI 查看

在 Google Colab 中執行

前往 GitHub 查看原始碼

本快速入門導覽課程說明如何使用 Python SDK for Gemini API，可讓你使用 Google 的 Gemini 大型語言模型。在本快速入門導覽課程中您將瞭解如何：

設定開發環境和 API 存取權，以便使用 Gemini。
依據文字輸入內容生成文字回覆。
使用多模態輸入內容 (文字和圖片) 生成文字回應。
使用 Gemini 進行多輪對話 (聊天)。
針對大型語言模型使用嵌入。

必要條件

您可以在 Google Cloud 控制台 Colab 能直接在瀏覽器中執行這個筆記本環境設定

或者，如要在本機完成本快速入門導覽課程，請確保您的開發環境必須符合下列需求：

Python 3.9 以上版本
安裝 jupyter 以執行筆記本。

設定

安裝 Python SDK

Gemini API 適用的 Python SDK 包含在 google-generativeai 套件。使用 pip 安裝依附元件：

pip install -q -U google-generativeai

匯入套件

匯入必要的套件。

import pathlib
import textwrap

import google.generativeai as genai

from IPython.display import display
from IPython.display import Markdown

def to_markdown(text):
  text = text.replace('•', '  *')
  return Markdown(textwrap.indent(text, '> ', predicate=lambda _: True))

# Used to securely store your API key
from google.colab import userdata

設定 API 金鑰

您必須先取得 API 金鑰，才能使用 Gemini API。如果發生以下情況：如果您還沒有金鑰，在 Google AI Studio 中按一下滑鼠就能建立金鑰。

取得 API 金鑰

在 Colab 中，將金鑰新增至密鑰管理員下方的「🔑?」。輸入名稱 GOOGLE_API_KEY。

取得 API 金鑰後，請將其傳遞至 SDK。您可以透過兩種方法來選擇刊登位置：

將金鑰放入 GOOGLE_API_KEY 環境變數中 (SDK 會就會自動從該處取得內容)。
將金鑰傳遞至 genai.configure(api_key=...)

# Or use `os.getenv('GOOGLE_API_KEY')` to fetch an environment variable.
GOOGLE_API_KEY=userdata.get('GOOGLE_API_KEY')

genai.configure(api_key=GOOGLE_API_KEY)

列出模型

您現在可以呼叫 Gemini API 了。使用「list_models」查看可用的 Gemini 模型：

gemini-1.5-flash：我們最快的多模態模型
gemini-1.5-pro：我們最強大的智慧多模態模型

，瞭解如何調查及移除這項存取權。

for m in genai.list_models():
  if 'generateContent' in m.supported_generation_methods:
    print(m.name)

使用輸入的文字來生成文字

如果是純文字提示，請使用 Gemini 1.5 模型或 Gemini 1.0 Pro 模型：

model = genai.GenerativeModel('gemini-1.5-flash')

generate_content 方法可處理多種用途，包括多輪對話和多模態輸入，具體取決於基礎模型支援。可用的模型僅支援文字和圖片做為輸入內容和文字做為輸出內容

在最簡單的情況下，您可以將提示字串傳遞至 GenerativeModel.generate_content 方法：

%%time
response = model.generate_content("What is the meaning of life?")

CPU times: user 110 ms, sys: 12.3 ms, total: 123 ms
Wall time: 8.25 s

在簡單的情況下，您只需要 response.text 存取子即可。顯示已設定格式化的 Markdown 文字，請使用 to_markdown 函式：

to_markdown(response.text)

The query of life's purpose has perplexed people across centuries, cultures, and continents. While there is no universally recognized response, many ideas have been put forth, and the response is frequently dependent on individual ideas, beliefs, and life experiences.

1. **Happiness and Well-being:** Many individuals believe that the goal of life is to attain personal happiness and well-being. This might entail locating pursuits that provide joy, establishing significant connections, caring for one's physical and mental health, and pursuing personal goals and interests.

2. **Meaningful Contribution:** Some believe that the purpose of life is to make a meaningful contribution to the world. This might entail pursuing a profession that benefits others, engaging in volunteer or charitable activities, generating art or literature, or inventing.

3. **Self-realization and Personal Growth:** The pursuit of self-realization and personal development is another common goal in life. This might entail learning new skills, pushing one's boundaries, confronting personal obstacles, and evolving as a person.

4. **Ethical and Moral Behavior:** Some believe that the goal of life is to act ethically and morally. This might entail adhering to one's moral principles, doing the right thing even when it is difficult, and attempting to make the world a better place.

5. **Spiritual Fulfillment:** For some, the purpose of life is connected to spiritual or religious beliefs. This might entail seeking a connection with a higher power, practicing religious rituals, or following spiritual teachings.

6. **Experiencing Life to the Fullest:** Some individuals believe that the goal of life is to experience all that it has to offer. This might entail traveling, trying new things, taking risks, and embracing new encounters.

7. **Legacy and Impact:** Others believe that the purpose of life is to leave a lasting legacy and impact on the world. This might entail accomplishing something noteworthy, being remembered for one's contributions, or inspiring and motivating others.

8. **Finding Balance and Harmony:** For some, the purpose of life is to find balance and harmony in all aspects of their lives. This might entail juggling personal, professional, and social obligations, seeking inner peace and contentment, and living a life that is in accordance with one's values and beliefs.

Ultimately, the meaning of life is a personal journey, and different individuals may discover their own unique purpose through their experiences, reflections, and interactions with the world around them.

如果 API 無法傳回結果，請使用 GenerateContentResponse.prompt_feedback ，瞭解系統是否因提示安全疑慮而遭到封鎖。

response.prompt_feedback

safety_ratings {
  category: HARM_CATEGORY_SEXUALLY_EXPLICIT
  probability: NEGLIGIBLE
}
safety_ratings {
  category: HARM_CATEGORY_HATE_SPEECH
  probability: NEGLIGIBLE
}
safety_ratings {
  category: HARM_CATEGORY_HARASSMENT
  probability: NEGLIGIBLE
}
safety_ratings {
  category: HARM_CATEGORY_DANGEROUS_CONTENT
  probability: NEGLIGIBLE
}

Gemini 可以針對單一提示生成多個可能的回覆。這些稱為 candidates，您可以在查看時選取最合適的解決方案

查看候選人的候選人 GenerateContentResponse.candidates：

response.candidates

[
content {
parts {
text: "The query of life\'s purpose has perplexed people across centuries, cultures, and continents. While there is no universally recognized response, many ideas have been put forth, and the response is frequently dependent on individual ideas, beliefs, and life experiences.\n\n1. **Happiness and Well-being:** Many individuals believe that the goal of life is to attain personal happiness and well-being. This might entail locating pursuits that provide joy, establishing significant connections, caring for one\'s physical and mental health, and pursuing personal goals and interests.\n\n2. **Meaningful Contribution:** Some believe that the purpose of life is to make a meaningful contribution to the world. This might entail pursuing a profession that benefits others, engaging in volunteer or charitable activities, generating art or literature, or inventing.\n\n3. **Self-realization and Personal Growth:** The pursuit of self-realization and personal development is another common goal in life. This might entail learning new skills, pushing one\'s boundaries, confronting personal obstacles, and evolving as a person.\n\n4. **Ethical and Moral Behavior:** Some believe that the goal of life is to act ethically and morally. This might entail adhering to one\'s moral principles, doing the right thing even when it is difficult, and attempting to make the world a better place.\n\n5. **Spiritual Fulfillment:** For some, the purpose of life is connected to spiritual or religious beliefs. This might entail seeking a connection with a higher power, practicing religious rituals, or following spiritual teachings.\n\n6. **Experiencing Life to the Fullest:** Some individuals believe that the goal of life is to experience all that it has to offer. This might entail traveling, trying new things, taking risks, and embracing new encounters.\n\n7. **Legacy and Impact:** Others believe that the purpose of life is to leave a lasting legacy and impact on the world. This might entail accomplishing something noteworthy, being remembered for one\'s contributions, or inspiring and motivating others.\n\n8. **Finding Balance and Harmony:** For some, the purpose of life is to find balance and harmony in all aspects of their lives. This might entail juggling personal, professional, and social obligations, seeking inner peace and contentment, and living a life that is in accordance with one\'s values and beliefs.\n\nUltimately, the meaning of life is a personal journey, and different individuals may discover their own unique purpose through their experiences, reflections, and interactions with the world around them."
}
role: "model"
}
finish_reason: STOP
index: 0
safety_ratings {
category: HARM_CATEGORY_SEXUALLY_EXPLICIT
probability: NEGLIGIBLE
}
safety_ratings {
category: HARM_CATEGORY_HATE_SPEECH
probability: NEGLIGIBLE
}
safety_ratings {
category: HARM_CATEGORY_HARASSMENT
probability: NEGLIGIBLE
}
safety_ratings {
category: HARM_CATEGORY_DANGEROUS_CONTENT
probability: NEGLIGIBLE
}
]

根據預設，模型會在完成整個生成程序後傳回回應上傳資料集之後，您可以運用 AutoML 自動完成部分資料準備工作您也可以串流系統產生的回應模型會在產生回應的區塊時立即傳回

如要逐句顯示回覆，請使用 GenerativeModel.generate_content(..., stream=True)。

%%time
response = model.generate_content("What is the meaning of life?", stream=True)

CPU times: user 102 ms, sys: 25.1 ms, total: 128 ms
Wall time: 7.94 s

for chunk in response:
  print(chunk.text)
  print("_"*80)

The query of life's purpose has perplexed people across centuries, cultures, and
________________________________________________________________________________
continents. While there is no universally recognized response, many ideas have been put forth, and the response is frequently dependent on individual ideas, beliefs, and life experiences
________________________________________________________________________________
.

2. **Meaning
________________________________________________________________________________
ful Contribution:** Some believe that the purpose of life is to make a meaningful contribution to the world. This might entail pursuing a profession that benefits others, engaging in volunteer or charitable activities, generating art or literature, or inventing.

3. **Self-realization and Personal Growth:** The pursuit of self-realization and personal development is another common goal in life. This might entail learning new skills, exploring one's interests and abilities, overcoming obstacles, and becoming the best version of oneself.

4. **Connection and Relationships:** For many individuals, the purpose of life is found in their relationships with others. This might entail building
________________________________________________________________________________
strong bonds with family and friends, fostering a sense of community, and contributing to the well-being of those around them.

5. **Spiritual Fulfillment:** For those with religious or spiritual beliefs, the purpose of life may be centered on seeking spiritual fulfillment or enlightenment. This might entail following religious teachings, engaging in spiritual practices, or seeking a deeper understanding of the divine.

6. **Experiencing the Journey:** Some believe that the purpose of life is simply to experience the journey itself, with all its joys and sorrows. This perspective emphasizes embracing the present moment, appreciating life's experiences, and finding meaning in the act of living itself.

7. **Legacy and Impact:** For others, the goal of life is to leave a lasting legacy or impact on the world. This might entail making a significant contribution to a particular field, leaving a positive mark on future generations, or creating something that will be remembered and cherished long after one's lifetime.

Ultimately, the meaning of life is a personal and subjective question, and there is no single, universally accepted answer. It is about discovering what brings you fulfillment, purpose, and meaning in your own life, and living in accordance with those values.
________________________________________________________________________________

在串流時，某些回應屬性需要經過疊代才能使用回應所有片段示範方式如下：

response = model.generate_content("What is the meaning of life?", stream=True)

prompt_feedback 屬性的運作方式如下：

response.prompt_feedback

safety_ratings {
  category: HARM_CATEGORY_SEXUALLY_EXPLICIT
  probability: NEGLIGIBLE
}
safety_ratings {
  category: HARM_CATEGORY_HATE_SPEECH
  probability: NEGLIGIBLE
}
safety_ratings {
  category: HARM_CATEGORY_HARASSMENT
  probability: NEGLIGIBLE
}
safety_ratings {
  category: HARM_CATEGORY_DANGEROUS_CONTENT
  probability: NEGLIGIBLE
}

但 text 等屬性則不會：

try:
  response.text
except Exception as e:
  print(f'{type(e).__name__}: {e}')

IncompleteIterationError: Please let the response complete iteration before accessing the final accumulated
attributes (or call `response.resolve()`)

依據圖片和文字輸入內容來生成文字

Gemini 提供各種模型，可處理多模態輸入 (Gemini 1.5) 讓您輸入文字和圖片。請務必詳閱提示的圖片相關規定。

如果提示輸入內容包含文字和圖片，請使用 Gemini 1.5，搭配產生文字輸出的 GenerativeModel.generate_content 方法：

加入圖片：

curl -o image.jpg https://t0.gstatic.com/licensed-image?q=tbn:ANd9GcQ_Kevbk21QBRy-PgB4kQpS79brbmmEG7m3VOTShAn4PecDU5H5UxrJxE3Dw1JiaG17V88QIol19-3TM2wCHw

% Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed

  0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0
100  405k  100  405k    0     0  6982k      0 --:--:-- --:--:-- --:--:-- 7106k

import PIL.Image

img = PIL.Image.open('image.jpg')
img

png

使用 Gemini 1.5 模型，並透過 generate_content 將圖片傳送至模型。

model = genai.GenerativeModel('gemini-1.5-flash')

response = model.generate_content(img)

to_markdown(response.text)

Chicken Teriyaki Meal Prep Bowls with brown rice, roasted broccoli and bell peppers.

如要在提示中提供文字和圖片，請傳送含有字串的清單和圖片：

response = model.generate_content(["Write a short, engaging blog post based on this picture. It should include a description of the meal in the photo and talk about my journey meal prepping.", img], stream=True)
response.resolve()

to_markdown(response.text)

Meal prepping is a great way to save time and money, and it can also help you to eat healthier. This meal is a great example of a healthy and delicious meal that can be easily prepped ahead of time.

This meal features brown rice, roasted vegetables, and chicken teriyaki. The brown rice is a whole grain that is high in fiber and nutrients. The roasted vegetables are a great way to get your daily dose of vitamins and minerals. And the chicken teriyaki is a lean protein source that is also packed with flavor.

This meal is easy to prepare ahead of time. Simply cook the brown rice, roast the vegetables, and cook the chicken teriyaki. Then, divide the meal into individual containers and store them in the refrigerator. When you're ready to eat, simply grab a container and heat it up.

This meal is a great option for busy people who are looking for a healthy and delicious way to eat. It's also a great meal for those who are trying to lose weight or maintain a healthy weight.

If you're looking for a healthy and delicious meal that can be easily prepped ahead of time, this meal is a great option. Give it a try today!

即時通訊對話

Gemini 讓您可以輪流進行各種語音交流， ChatSession 類別可管理對話與 generate_content 不同，您無須儲存以清單形式顯示對話記錄

初始化即時通訊：

model = genai.GenerativeModel('gemini-1.5-flash')
chat = model.start_chat(history=[])
chat

<google.generativeai.generative_models.ChatSession at 0x7b7b68250100>

ChatSession.send_message 方法會傳回與GenerateContentResponse GenerativeModel.generate_content。系統也會將您的訊息和回覆附加到即時通訊記錄中：

response = chat.send_message("In one sentence, explain how a computer works to a young child.")
to_markdown(response.text)

A computer is like a very smart machine that can understand and follow our instructions, help us with our work, and even play games with us!

chat.history

[
  parts {
    text: "In one sentence, explain how a computer works to a young child."
  }
  role: "user",
  parts {
    text: "A computer is like a very smart machine that can understand and follow our instructions, help us with our work, and even play games with us!"
  }
  role: "model"
]

你可以繼續傳送訊息，繼續對話。使用 stream=True 引數，用於串流即時通訊：

response = chat.send_message("Okay, how about a more detailed explanation to a high schooler?", stream=True)

for chunk in response:
  print(chunk.text)
  print("_"*80)

A computer works by following instructions, called a program, which tells it what to
________________________________________________________________________________
 do. These instructions are written in a special language that the computer can understand, and they are stored in the computer's memory. The computer's processor
________________________________________________________________________________
, or CPU, reads the instructions from memory and carries them out, performing calculations and making decisions based on the program's logic. The results of these calculations and decisions are then displayed on the computer's screen or stored in memory for later use.

To give you a simple analogy, imagine a computer as a
________________________________________________________________________________
 chef following a recipe. The recipe is like the program, and the chef's actions are like the instructions the computer follows. The chef reads the recipe (the program) and performs actions like gathering ingredients (fetching data from memory), mixing them together (performing calculations), and cooking them (processing data). The final dish (the output) is then presented on a plate (the computer screen).

In summary, a computer works by executing a series of instructions, stored in its memory, to perform calculations, make decisions, and display or store the results.
________________________________________________________________________________

glm.Content 物件包含 glm.Part 物件清單，每個物件都包含文字 (字串) 或 inline_data (glm.Blob)，其中 blob 含有二進位資料和 mime_type即時通訊記錄是以 glm.Content 清單的形式顯示物件 ChatSession.history：

for message in chat.history:
  display(to_markdown(f'**{message.role}**: {message.parts[0].text}'))

**user**: In one sentence, explain how a computer works to a young child.

**model**: A computer is like a very smart machine that can understand and follow our instructions, help us with our work, and even play games with us!

**user**: Okay, how about a more detailed explanation to a high schooler?

**model**: A computer works by following instructions, called a program, which tells it what to do. These instructions are written in a special language that the computer can understand, and they are stored in the computer's memory. The computer's processor, or CPU, reads the instructions from memory and carries them out, performing calculations and making decisions based on the program's logic. The results of these calculations and decisions are then displayed on the computer's screen or stored in memory for later use.

To give you a simple analogy, imagine a computer as a chef following a recipe. The recipe is like the program, and the chef's actions are like the instructions the computer follows. The chef reads the recipe (the program) and performs actions like gathering ingredients (fetching data from memory), mixing them together (performing calculations), and cooking them (processing data). The final dish (the output) is then presented on a plate (the computer screen).

In summary, a computer works by executing a series of instructions, stored in its memory, to perform calculations, make decisions, and display or store the results.

計算符記數量

大型語言模型有背景脈絡窗口，通常依據符記數量計算。Gemini API 提供以下功能：確定每個 genai.protos.Content 物件的符記數量。在最簡單的情況下，您可以將查詢字串傳送至 GenerativeModel.count_tokens 方法如下所示：

model.count_tokens("What is the meaning of life?")

total_tokens: 7

同樣地，您也可以為 ChatSession 檢查 token_count：

model.count_tokens(chat.history)

total_tokens: 501

使用嵌入

嵌入是一種將資訊以浮點數清單表示的技術陣列。Gemini 可以表示文字 (字詞、句子和區塊) 轉換成向量形式，方便比對與對比和一些嵌入舉例來說，如果兩則文本具有相同主旨，或是情緒應有類似的嵌入，可透過以下方法識別：數學比較技巧，例如餘弦相似度。如要進一步瞭解以及為何應使用嵌入功能，請參考嵌入指南。

使用 embed_content 方法產生嵌入。方法會處理為下列工作嵌入 (task_type)：

工作類型	說明
RETRIEVAL_QUERY	指定指定文字是搜尋/擷取設定中的查詢。
RETRIEVAL_DOCUMENT	指定文字是搜尋/擷取設定中的文件。使用這個工作類型需要 `title`。
SEMANTIC_SIMILARITY	指定指定文字將用於語意文字相似度 (STS)。
分類	指定要將嵌入用於分類。
叢集	指定嵌入將用於分群。

以下程式碼會產生用於擷取文件的單一字串嵌入：

result = genai.embed_content(
    model="models/embedding-001",
    content="What is the meaning of life?",
    task_type="retrieval_document",
    title="Embedding of single string")

# 1 input > 1 vector output
print(str(result['embedding'])[:50], '... TRIMMED]')

[-0.003216741, -0.013358698, -0.017649598, -0.0091 ... TRIMMED]

如要處理整批字串，請在 content 中傳遞字串清單：

result = genai.embed_content(
    model="models/embedding-001",
    content=[
      'What is the meaning of life?',
      'How much wood would a woodchuck chuck?',
      'How does the brain work?'],
    task_type="retrieval_document",
    title="Embedding of list of strings")

# A list of inputs > A list of vectors output
for v in result['embedding']:
  print(str(v)[:50], '... TRIMMED ...')

[0.0040260437, 0.004124458, -0.014209415, -0.00183 ... TRIMMED ...
[-0.004049845, -0.0075574904, -0.0073463684, -0.03 ... TRIMMED ...
[0.025310587, -0.0080734305, -0.029902633, 0.01160 ... TRIMMED ...

雖然 genai.embed_content 函式接受字串或字串清單，但其實是圍繞 genai.protos.Content 類型建構而成 (例如 GenerativeModel.generate_content)。 glm.Content 物件是 API 中的對話主要單位。

genai.protos.Content 物件為多模態時，embed_content 方法僅支援文字嵌入。此設計讓 API 可能性：展開至多模態嵌入。

response.candidates[0].content

parts {
  text: "A computer works by following instructions, called a program, which tells it what to do. These instructions are written in a special language that the computer can understand, and they are stored in the computer\'s memory. The computer\'s processor, or CPU, reads the instructions from memory and carries them out, performing calculations and making decisions based on the program\'s logic. The results of these calculations and decisions are then displayed on the computer\'s screen or stored in memory for later use.\n\nTo give you a simple analogy, imagine a computer as a chef following a recipe. The recipe is like the program, and the chef\'s actions are like the instructions the computer follows. The chef reads the recipe (the program) and performs actions like gathering ingredients (fetching data from memory), mixing them together (performing calculations), and cooking them (processing data). The final dish (the output) is then presented on a plate (the computer screen).\n\nIn summary, a computer works by executing a series of instructions, stored in its memory, to perform calculations, make decisions, and display or store the results."
}
role: "model"

result = genai.embed_content(
    model = 'models/embedding-001',
    content = response.candidates[0].content)

# 1 input > 1 vector output
print(str(result['embedding'])[:50], '... TRIMMED ...')

[-0.013921871, -0.03504407, -0.0051786783, 0.03113 ... TRIMMED ...

同樣地，即時通訊記錄包含 genai.protos.Content 物件清單。您可以直接傳遞到 embed_content 函式：

chat.history

[
  parts {
    text: "In one sentence, explain how a computer works to a young child."
  }
  role: "user",
  parts {
    text: "A computer is like a very smart machine that can understand and follow our instructions, help us with our work, and even play games with us!"
  }
  role: "model",
  parts {
    text: "Okay, how about a more detailed explanation to a high schooler?"
  }
  role: "user",
  parts {
    text: "A computer works by following instructions, called a program, which tells it what to do. These instructions are written in a special language that the computer can understand, and they are stored in the computer\'s memory. The computer\'s processor, or CPU, reads the instructions from memory and carries them out, performing calculations and making decisions based on the program\'s logic. The results of these calculations and decisions are then displayed on the computer\'s screen or stored in memory for later use.\n\nTo give you a simple analogy, imagine a computer as a chef following a recipe. The recipe is like the program, and the chef\'s actions are like the instructions the computer follows. The chef reads the recipe (the program) and performs actions like gathering ingredients (fetching data from memory), mixing them together (performing calculations), and cooking them (processing data). The final dish (the output) is then presented on a plate (the computer screen).\n\nIn summary, a computer works by executing a series of instructions, stored in its memory, to perform calculations, make decisions, and display or store the results."
  }
  role: "model"
]

result = genai.embed_content(
    model = 'models/embedding-001',
    content = chat.history)

# 1 input > 1 vector output
for i,v in enumerate(result['embedding']):
  print(str(v)[:50], '... TRIMMED...')

[-0.014632266, -0.042202696, -0.015757175, 0.01548 ... TRIMMED...
[-0.010979066, -0.024494737, 0.0092659835, 0.00803 ... TRIMMED...
[-0.010055617, -0.07208932, -0.00011750793, -0.023 ... TRIMMED...
[-0.013921871, -0.03504407, -0.0051786783, 0.03113 ... TRIMMED...

進階用途

下列各節將討論進階用途以及 Gemini API 適用的 Python SDK。

安全性設定

safety_settings 引數可讓您設定模型區塊和能讓你透過提示和回應根據預設，安全性設定會封鎖內容整體而言，中等和/或很有可能屬於不安全的內容維度。進一步瞭解安全性設定。

輸入可疑的提示，並以預設安全性設定執行模型。且不會傳回任何候選文字：

response = model.generate_content('[Questionable prompt here]')
response.candidates

[
  content {
    parts {
      text: "I\'m sorry, but this prompt involves a sensitive topic and I\'m not allowed to generate responses that are potentially harmful or inappropriate."
    }
    role: "model"
  }
  finish_reason: STOP
  index: 0
  safety_ratings {
    category: HARM_CATEGORY_SEXUALLY_EXPLICIT
    probability: NEGLIGIBLE
  }
  safety_ratings {
    category: HARM_CATEGORY_HATE_SPEECH
    probability: NEGLIGIBLE
  }
  safety_ratings {
    category: HARM_CATEGORY_HARASSMENT
    probability: NEGLIGIBLE
  }
  safety_ratings {
    category: HARM_CATEGORY_DANGEROUS_CONTENT
    probability: NEGLIGIBLE
  }
]

prompt_feedback 會顯示哪個安全篩選器封鎖了提示：

response.prompt_feedback

safety_ratings {
  category: HARM_CATEGORY_SEXUALLY_EXPLICIT
  probability: NEGLIGIBLE
}
safety_ratings {
  category: HARM_CATEGORY_HATE_SPEECH
  probability: NEGLIGIBLE
}
safety_ratings {
  category: HARM_CATEGORY_HARASSMENT
  probability: NEGLIGIBLE
}
safety_ratings {
  category: HARM_CATEGORY_DANGEROUS_CONTENT
  probability: NEGLIGIBLE
}

現在向模型提供同樣的提示，並設定新的安全性設定你可能會收到回覆

response = model.generate_content('[Questionable prompt here]',
                                  safety_settings={'HARASSMENT':'block_none'})
response.text

另請注意，在系統提示時，每位候選人都有自己的 safety_ratings 通過，但個別回應則未通過安全檢查。

將訊息編碼

先前章節都仰賴 SDK，方便您傳送提示至 API本章節提供完整類型與上文例如，您可以更清楚地瞭解 SDK 會將訊息編碼。

SDK 會嘗試將訊息轉換為 genai.protos.Content 物件。其中包含一個 genai.protos.Part 物件清單，每個物件都包含下列任一項：

text (字串)
inline_data (genai.protos.Blob)，其中 blob 含有二進位 data 和 mime_type。
或其他類型的資料

您也可以傳遞任一個類別，做為對等的字典。

因此，與上述範例的完整型別相等為：

model = genai.GenerativeModel('gemini-1.5-flash')
response = model.generate_content(
    genai.protos.Content(
        parts = [
            genai.protos.Part(text="Write a short, engaging blog post based on this picture."),
            genai.protos.Part(
                inline_data=genai.protos.Blob(
                    mime_type='image/jpeg',
                    data=pathlib.Path('image.jpg').read_bytes()
                )
            ),
        ],
    ),
    stream=True)

response.resolve()

to_markdown(response.text[:100] + "... [TRIMMED] ...")

Meal prepping is a great way to save time and money, and it can also help you to eat healthier. By ... [TRIMMED] ...

多轉折對話

雖然前述的 genai.ChatSession 類別可以處理許多用途，確實會做出一些假設如果你的用途不符合這次即時通訊的用途建議您瞭解，genai.ChatSession 只是包裝函式左右 GenerativeModel.generate_content。除了單一要求外，還可處理多輪對話。

個別訊息為 genai.protos.Content 物件或相容的如前一節所述。做為字典需要 role 和 parts 組金鑰。對話中的 role 可以是 user，提供提示或model提供回應。

傳遞 genai.protos.Content 物件清單，系統會將該物件視為多輪對話：

model = genai.GenerativeModel('gemini-1.5-flash')

messages = [
    {'role':'user',
     'parts': ["Briefly explain how a computer works to a young child."]}
]
response = model.generate_content(messages)

to_markdown(response.text)

Imagine a computer as a really smart friend who can help you with many things. Just like you have a brain to think and learn, a computer has a brain too, called a processor. It's like the boss of the computer, telling it what to do.

Inside the computer, there's a special place called memory, which is like a big storage box. It remembers all the things you tell it to do, like opening games or playing videos.

When you press buttons on the keyboard or click things on the screen with the mouse, you're sending messages to the computer. These messages travel through special wires, called cables, to the processor.

The processor reads the messages and tells the computer what to do. It can open programs, show you pictures, or even play music for you.

All the things you see on the screen are created by the graphics card, which is like a magic artist inside the computer. It takes the processor's instructions and turns them into colorful pictures and videos.

To save your favorite games, videos, or pictures, the computer uses a special storage space called a hard drive. It's like a giant library where the computer can keep all your precious things safe.

And when you want to connect to the internet to play games with friends or watch funny videos, the computer uses something called a network card to send and receive messages through the internet cables or Wi-Fi signals.

So, just like your brain helps you learn and play, the computer's processor, memory, graphics card, hard drive, and network card all work together to make your computer a super-smart friend that can help you do amazing things!

如要繼續對話，請新增回覆和其他訊息。

messages.append({'role':'model',
                 'parts':[response.text]})

messages.append({'role':'user',
                 'parts':["Okay, how about a more detailed explanation to a high school student?"]})

response = model.generate_content(messages)

to_markdown(response.text)

At its core, a computer is a machine that can be programmed to carry out a set of instructions. It consists of several essential components that work together to process, store, and display information:

**1. Processor (CPU):**
- The brain of the computer.
- Executes instructions and performs calculations.
- Speed measured in gigahertz (GHz).
- More GHz generally means faster processing.

**2. Memory (RAM):**
- Temporary storage for data being processed.
- Holds instructions and data while the program is running.
- Measured in gigabytes (GB).
- More GB of RAM allows for more programs to run simultaneously.

**3. Storage (HDD/SSD):**
- Permanent storage for data.
- Stores operating system, programs, and user files.
- Measured in gigabytes (GB) or terabytes (TB).
- Hard disk drives (HDDs) are traditional, slower, and cheaper.
- Solid-state drives (SSDs) are newer, faster, and more expensive.

**4. Graphics Card (GPU):**
- Processes and displays images.
- Essential for gaming, video editing, and other graphics-intensive tasks.
- Measured in video RAM (VRAM) and clock speed.

**5. Motherboard:**
- Connects all the components.
- Provides power and communication pathways.

**6. Input/Output (I/O) Devices:**
- Allow the user to interact with the computer.
- Examples: keyboard, mouse, monitor, printer.

**7. Operating System (OS):**
- Software that manages the computer's resources.
- Provides a user interface and basic functionality.
- Examples: Windows, macOS, Linux.

When you run a program on your computer, the following happens:

1. The program instructions are loaded from storage into memory.
2. The processor reads the instructions from memory and executes them one by one.
3. If the instruction involves calculations, the processor performs them using its arithmetic logic unit (ALU).
4. If the instruction involves data, the processor reads or writes to memory.
5. The results of the calculations or data manipulation are stored in memory.
6. If the program needs to display something on the screen, it sends the necessary data to the graphics card.
7. The graphics card processes the data and sends it to the monitor, which displays it.

This process continues until the program has completed its task or the user terminates it.

產生設定

generation_config 引數可讓您修改生成參數。您傳送至模型的每個提示都含有參數值，用來控制模型會產生回應

model = genai.GenerativeModel('gemini-1.5-flash')
response = model.generate_content(
    'Tell me a story about a magic backpack.',
    generation_config=genai.types.GenerationConfig(
        # Only one candidate for now.
        candidate_count=1,
        stop_sequences=['x'],
        max_output_tokens=20,
        temperature=1.0)
)

text = response.text

if response.candidates[0].finish_reason.name == "MAX_TOKENS":
    text += '...'

to_markdown(text)

Once upon a time, in a small town nestled amidst lush green hills, lived a young girl named...

後續步驟

「提示設計」是指建立提示來促成所需流程的過程語言模型的回應如何撰寫條理分明的提示確保使用者能從特定語言取得準確且高品質的回覆模型瞭解提示的最佳做法撰寫
Gemini 提供多種模型版本，可滿足不同用途的需求例如輸入類型和複雜度、即時通訊等實作對話語言工作和大小限制進一步瞭解可用的 Gemini 模型。