2024年9月1日 星期日

申請 Google Gemini API Key

今天繼續複習前三周 ESP32-CAM 的上課錄影, 科目是利用大語言模型做圖像辨識 (車牌號碼), 老師使用的是谷歌的 Gemini, 首先要去申請 API Key, 網址如下 (要先登入 Google 帳號) :


按 "Get API Key" 鈕 : 




勾選彈出視窗中的第一項 (同意使用條款) 後按 Continue 鈕 :




按中間的 "Create API key" :




按 "Got it" :




按 "Create API key in new project" 鈕 :




這樣就建立了第一個 API key, 先按 Copy 鈕將其複製到記事本檔案中保存 :




按右上角的 X 關閉 API key 視窗回到主頁面時會看到所建立的 API key 已經表列在右下角 (可以為不同專案建立多個 API key), 最後面的 "Free of Charge" 表示為可免費使用 : 




按 API key 欄位超連結會顯示 API key 內容, 表示可以隨時回來取得已建立過的 API key, 這是與其他網站服務權杖建立後無法再查找不同之處. 




Google Gemini 目前最強的模型是 Gemini Pro 1.5, 免費方案的限制是每分鐘只能提出 2 次要求 (付費方案則為 360 次) 且每日上限 50 次, 每分鐘 token 數最高 32000 個 (付費方案則為 400 萬個) :




另一個模型是 1.5 Flash, 其速度較快, 免費額度也比較高 (每分鐘最多 15 次呼叫, 全日上限 1500 次, 每分鐘 token 數最高 100 萬次), 對於物聯網應用很足夠 :




參考 : 


接下來用線上 API 測試網站 Postman 來向 Gemini 提出請求 :


先登入 Postman 帳戶 :




登入後會顯示 API Network 頁面, 按 "Send an API request" 欄右邊的 "New Request" 按鈕 :




左上角選 POST 方法, 在後面的 URL 欄位貼上 API 網址 : 

https://generativelanguage.googleapis.com/v1/models/gemini-1.5-flash:generateContent

然後點選底下的 Params 頁籤, 在 Key 欄位填入 key (注意是全部小寫), 在 Value 欄位複製貼上上面建立的 API Key :




接著點選 Body 頁籤, 點選 Raw 與 JSON, 在底下輸入 JSON 格式的詢問內容, 其中的 text 屬性值就是向 Gemini 詢問的問題 : 

{
    "contents": [{
    "parts": [{ "text": "請推薦一個台灣美食" }]
    }]
}

最後按 SEND 鍵向 Gemini 發出請求, 結果會顯示在下方 :




其中 parts 屬性值即 Gemini 的回答內容. 

以上的 POST 請求的完整 HTTP  訊息可以按 SEND 鍵右上角的 Code snippet 鍵 </> 找到 : 




選擇 HTTP 即可 : 





關於 Postman 用法參考 :


沒有留言 :