iT邦幫忙

2026 iThome 鐵人賽

DAY 2
0
AI 自動化

實戰打造個人專屬 AI 自動化工作流:從零建立高效生產力系統系列 第 3

環境建置與資安隔離:成功發送你的第一個 Gemini API 請求

  • 分享至 

  • xImage
  •  

前言:開發 AI 自動化工具的第一步,就是打造一個乾淨且安全的開發環境。今天我們將從 Python 虛擬環境建立開始,一路完成 API Key 安全隔離,並成功發送第一個請求給 Gemini!

一、 建立與啟用 Python 虛擬環境 (venv)
1.建立虛擬環境
py -m venv venv
2.啟用虛擬環境
.\venv\Scripts\Activate.ps1
踩坑紀錄:PowerShell 執行策略阻擋
第一次在 Windows 執行時若出現 PSSecurityException 錯誤,這是系統預設的安全保護機制。只需在 PowerShell 輸入以下指令解鎖權限即可:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

二、 安裝必要套件與資安防護 (.env)
在終端機出現 (venv) 後,安裝 SDK 與環境變數套件:
pip install google-genai python-dotenv
重要:API Key 資安隔離機制
絕對不能將 API 金鑰直接寫在程式碼中!我們採用 .env 檔案管理機密資料:
1.根目錄建立 .env 檔案:
GEMINI_API_KEY=你的_GEMINI_API_KEY
2.建立 .gitignore 檔案(防止機密檔案被 Git 追蹤):
venv/
.env
pycache/
.pyc
三、 撰寫測試腳本 day03test.py
使用官方最新 google-genai SDK,並透過 python-dotenv 安全載入 API 金鑰
四、 實戰除錯紀錄
在實際串接 API 的過程中,我們遇到了以下幾個常見問題與解決方案:
404 NOTFOUND 錯誤:舊版模型名稱(如 gemini-1.5-flash 或 gemini-2.0-flash)可能已被官方停用或調整。可使用 client.models.list() 查詢當前帳號支援的最新模型清單,並指定如 gemini-3.6-flash 之新版名稱。
503 UNAVAILABLE 錯誤:代表免費伺服器瞬間請求流量過高。這屬於暫時性的伺服器負載問題,程式碼與金鑰設定本身均為正確,稍作等待後重新執行即可。

結語
當終端機順利印出 AI 助教的回覆訊息時,代表我們的開發環境與 API 通道已經完全打通!
https://ithelp.ithome.com.tw/upload/images/20260918/20184356T90Qa4TMFV.png


上一篇
打造個人 AI 助教:系統架構設計與學生黨 $0 預算全免費 API 策略
下一篇
PDF 講義自動讀取與解析!
系列文
實戰打造個人專屬 AI 自動化工作流:從零建立高效生產力系統4
圖片
  熱門推薦
圖片
{{ item.channelVendor }} | {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言