取得 Gemini API 金鑰

您必須具備 API 金鑰，才能使用 Gemini API。只要在 Google AI Studio 中按幾下滑鼠，即可建立金鑰。

設定 API 金鑰

如要進行初步測試，您可以將 API 金鑰硬式編碼，但這僅適用於暫時性使用，因為這不安全。本節的其餘部分將說明如何在本機將 API 金鑰設為不同作業系統的環境變數。

Linux/macOS - Bash

Bash 是常見的 Linux 和 macOS 終端機設定。您可以執行下列指令，檢查是否有設定檔：

~/.bashrc

如果回應為「No such file or directory」，您必須建立這個檔案，然後執行下列指令或使用 zsh 來開啟檔案：

touch ~/.bashrc
open ~/.bashrc

接下來，您必須新增下列匯出指令，設定 API 金鑰：

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

儲存檔案後，請執行以下命令套用變更：

source ~/.bashrc

macOS - Zsh

Zsh 是常見的 Linux 和 macOS 終端機設定。您可以執行下列指令，檢查是否有相關設定檔：

~/.zshrc

如果回應為「No such file or directory」，您必須建立這個檔案，然後執行下列指令或使用 bash 來開啟檔案：

touch ~/.zshrc
open ~/.zshrc

接下來，您必須新增下列匯出指令，設定 API 金鑰：

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

儲存檔案後，請執行以下命令套用變更：

source ~/.zshrc

Windows

在系統設定中搜尋「環境變數」
編輯「使用者變數」(適用於目前使用者) 或「系統變數」(適用於所有使用者，請謹慎使用)。
建立變數並新增 export GEMINI_API_KEY=your_key_here
套用變更

傳送第一個 Gemini API 要求

您可以使用 curl 指令驗證設定：

  curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent?key=${GEMINI_API_KEY}" \
    -H 'Content-Type: application/json' \
    -X POST \
    -d '{
      "contents": [{
        "parts":[{"text": "Write a story about a magic backpack."}]
        }]
       }'

妥善保管 API 金鑰

請務必妥善保護 Gemini API 金鑰。使用 Gemini API 金鑰時，請注意下列事項：

Google AI Gemini API 會使用 API 金鑰進行授權。如果其他人取得 Gemini API 金鑰的存取權，他們就能使用專案的配額發出呼叫，這可能會導致配額耗盡或產生額外費用 (針對已計費的專案)，此外，他們還能存取經過調校的模型和檔案。
新增 API 金鑰限制有助於限制可透過各 API 金鑰使用的表面積。
您有責任妥善保管 Gemini API 金鑰。
- 請勿將 Gemini API 金鑰簽入原始碼控管。
- 用戶端應用程式 (Android、Swift、網頁和 Dart/Flutter) 可能會洩漏 API 金鑰。我們不建議在實際工作環境的應用程式中使用 Google AI 用戶端 SDK，直接從行動和網頁應用程式呼叫 Google AI Gemini API。

如需瞭解一些一般最佳做法，也可以參閱這篇支援文章。