本快速入門導覽課程說明如何安裝程式庫，並發出第一個 Gemini API 要求。
事前準備
您需要 Gemini API 金鑰。如果還沒有金鑰，可以在 Google AI Studio 免費取得。
安裝 Google GenAI SDK
Python
使用 Python 3.9 以上版本，透過下列 pip 指令安裝 google-genai 套件：
pip install -q -U google-genai JavaScript
使用 Node.js v18 以上版本，透過下列 npm 指令安裝 TypeScript 和 JavaScript 適用的 Google Gen AI SDK：
npm install @google/genai Go
在模組目錄中，使用 go get 指令安裝 google.golang.org/genai：
go get google.golang.org/genai Java
如果您使用 Maven，可以將下列項目新增至依附元件，安裝 google-genai：
<dependencies> <dependency> <groupId>com.google.genai</groupId> <artifactId>google-genai</artifactId> <version>1.0.0</version> </dependency> </dependencies> Apps Script
- 如要建立新的 Apps Script 專案，請前往 script.new。
- 按一下「未命名專案」。
- 將 Apps Script 專案重新命名為「AI Studio」，然後按一下「重新命名」。
- 設定 API 金鑰
- 按一下左側的「專案設定」圖示
。 - 在「指令碼屬性」下方，按一下「新增指令碼屬性」。
- 在「Property」(屬性) 中輸入鍵名：
GEMINI_API_KEY。 - 在「Value」(值) 部分輸入 API 金鑰的值。
- 按一下「儲存指令碼屬性」。
- 按一下左側的「專案設定」圖示
- 將
Code.gs檔案內容替換成下列程式碼：
發出第一項要求
以下範例使用 generateContent 方法，透過 Gemini 2.5 Flash 模型傳送要求至 Gemini API。
如果您將 API 金鑰設為環境變數 GEMINI_API_KEY，使用 Gemini API 程式庫時，用戶端會自動取得該金鑰。否則，您需要在初始化用戶端時傳遞 API 金鑰做為引數。
請注意，Gemini API 文件中的所有程式碼範例，都假設您已設定環境變數 GEMINI_API_KEY。
Python
from google import genai # The client gets the API key from the environment variable `GEMINI_API_KEY`. client = genai.Client() response = client.models.generate_content( model="gemini-2.5-flash", contents="Explain how AI works in a few words" ) print(response.text) JavaScript
import { GoogleGenAI } from "@google/genai"; // The client gets the API key from the environment variable `GEMINI_API_KEY`. const ai = new GoogleGenAI({}); async function main() { const response = await ai.models.generateContent({ model: "gemini-2.5-flash", contents: "Explain how AI works in a few words", }); console.log(response.text); } main(); Go
package main import ( "context" "fmt" "log" "google.golang.org/genai" ) func main() { ctx := context.Background() // The client gets the API key from the environment variable `GEMINI_API_KEY`. client, err := genai.NewClient(ctx, nil) if err != nil { log.Fatal(err) } result, err := client.Models.GenerateContent( ctx, "gemini-2.5-flash", genai.Text("Explain how AI works in a few words"), nil, ) if err != nil { log.Fatal(err) } fmt.Println(result.Text()) } Java
package com.example; import com.google.genai.Client; import com.google.genai.types.GenerateContentResponse; public class GenerateTextFromTextInput { public static void main(String[] args) { // The client gets the API key from the environment variable `GEMINI_API_KEY`. Client client = new Client(); GenerateContentResponse response = client.models.generateContent( "gemini-2.5-flash", "Explain how AI works in a few words", null); System.out.println(response.text()); } } Apps Script
// See https://developers.google.com/apps-script/guides/properties // for instructions on how to set the API key. const apiKey = PropertiesService.getScriptProperties().getProperty('GEMINI_API_KEY'); function main() { const payload = { contents: [ { parts: [ { text: 'Explain how AI works in a few words' }, ], }, ], }; const url = 'https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent'; const options = { method: 'POST', contentType: 'application/json', headers: { 'x-goog-api-key': apiKey, }, payload: JSON.stringify(payload) }; const response = UrlFetchApp.fetch(url, options); const data = JSON.parse(response); const content = data['candidates'][0]['content']['parts'][0]['text']; console.log(content); } REST
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent" \ -H "x-goog-api-key: $GEMINI_API_KEY" \ -H 'Content-Type: application/json' \ -X POST \ -d '{ "contents": [ { "parts": [ { "text": "Explain how AI works in a few words" } ] } ] }' 後續步驟
您已發出第一個 API 要求，現在不妨參考下列指南，瞭解 Gemini 的實際運作方式：