Gemini API 參考資料

本 API 參考文件介紹了可用於與 Gemini 模型互動的一元 API、串流 API 和即時 API。您可以在任何支援 HTTP 請求的環境中使用 REST API。請參閱 入門指南，以瞭解如何開始您的第一個 API 呼叫。如果您正在尋找我們特定語言庫和 SDK 的參考資料，請前往左側導覽列中 SDK 參考資料 下的相應語言連結。

主要終點

Gemini API 主要圍繞著以下幾個端點建構：

  • 交互作用（CreateInteraction）（建議）： 建議使用 Gemini 建構的標準原語，針對代理程式工作流程、伺服器端狀態管理和複雜的多模態、多輪對話進行了最佳化。
  • 標準內容產生（generateContent）： 一個標準的 REST 端點，用於處理您的請求並在單一套件中傳回模型的完整回應。這最適合非互動式任務，您可以等待整個結果。
  • 串流內容產生（streamGenerateContent）： 使用伺服器傳送事件 (SSE) 將產生的回應區塊推播給您。這為聊天機器人等應用程式提供了更快、更互動的體驗。
  • 即時 API (BidiGenerateContent): 一個基於 WebSocket 的有狀態雙向串流 API，專為即時對話用例而設計。
  • 批次模式（batchGenerateContent）： 用於提交批次 generateContent 請求的標準 REST 端點。
  • 嵌入（embedContent）： 一個標準的 REST 端點，它從輸入產生文字嵌入向量 Content。
  • Gen Media APIs：用於使用我們專用模型產生媒體的端點，例如用於影像生成的影像， 和Veo 用於視訊生成。 Gemini 也內建了這些功能，您可以使用 generateContent API 存取這些功能。
  • 平台 API：支援核心功能的實用程式端點，例如上傳文件， 和計數代幣。

驗證

所有對 Gemini API 的請求都必須包含帶有您的 API 金鑰的 x-goog-api-key 標頭。在 Google AI Studio 中，只需點擊幾下即可建立一個。

以下是一個範例請求，其中 API 金鑰包含在請求頭中：

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.8-flash",
    "input": "Explain how AI works in a few words"
  }'

有關如何使用 Gemini SDK 將金鑰傳遞給 API 的說明，請參閱 使用 Gemini API 金鑰 指南。