Gemini API 參考資料

這份 API 參考資料說明如何使用一元、串流和即時 API，與 Gemini 模型互動。您可以在支援 HTTP 要求的任何環境中使用 REST API。如要瞭解如何發出第一個 API 呼叫，請參閱入門指南。如要查看語言專屬程式庫和 SDK 的參考資料，請前往左側導覽面板「SDK 參考資料」下方的該語言連結。

主要端點

Gemini API 主要有下列端點：

• 互動 (CreateInteraction) (建議)： 建議使用這個標準基本項目搭配 Gemini 建構應用程式，因為它經過最佳化，可支援代理工作流程、伺服器端狀態管理，以及複雜的多模態多輪對話。
• 標準內容生成 (generateContent)： 標準 REST 端點，可處理您的要求，並以單一封包傳回模型的完整回應。這最適合非互動式工作，您可以等待整個結果。
• 串流生成內容 (streamGenerateContent)： 使用伺服器傳送事件 (SSE)，在生成回覆的同時，將回覆片段推送給您。為聊天機器人等應用程式提供更快速、更具互動性的體驗。
• Live API (BidiGenerateContent)：以 WebSocket 為基礎的具狀態 API，適用於雙向串流，專為即時對話使用情境設計。
• 批次模式 (batchGenerateContent)：標準 REST 端點，用於提交批次 generateContent 要求。
• 嵌入 (embedContent)：標準 REST 端點，可從輸入的 Content 生成文字嵌入向量。
• 生成媒體 API：端點，可使用我們的專用模型生成媒體，例如 Imagen 可生成圖像，Veo 可生成影片。 Gemini 也內建這些功能，您可以使用 generateContent API 存取。
• 平台 API：支援核心功能的實用端點，例如上傳檔案和計算權杖。

驗證

所有 Gemini API 要求都必須包含 x-goog-api-key 標頭和您的 API 金鑰。在 Google AI Studio 中按幾下滑鼠即可建立。

以下範例要求會在標頭中加入 API 金鑰：

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.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"
          }
        ]
      }
    ]
  }'

如要瞭解如何使用 Gemini SDK 將金鑰傳遞至 API，請參閱「使用 Gemini API 金鑰」指南。