Gemini API 参考文档

此 API 参考文档介绍了可用于与 Gemini 模型进行交互的一元 API、流式 API 和实时 API。您可以在任何支持 HTTP 请求的环境中使用 REST API。如需了解如何开始发出第一个 API 调用，请参阅入门指南。如果您要查找特定语言的库和 SDK 的参考信息，请在左侧导航栏中的 SDK 参考文档下找到相应语言的链接。

主要端点

Gemini API 围绕以下主要端点进行组织：

• 互动 (CreateInteraction)（推荐）：推荐用于构建 Gemini 应用的标准原语，针对代理工作流、服务器端状态管理以及复杂的多模态多轮对话进行了优化。
• 标准内容生成 (generateContent)： 一个标准 REST 端点，用于处理您的请求并在单个软件包中返回模型的完整回答。此方法最适合非互动任务，您可以等待整个结果。
• 流式内容生成 (streamGenerateContent)：使用服务器发送的事件 (SSE) 在生成回答块时将其推送给您。这可为聊天机器人等应用提供更快、更具互动性的体验。
• Live API (BidiGenerateContent)：一种基于 WebSocket 的有状态 API，用于双向流式传输，专为实时对话用例而设计。
• 批量模式 (batchGenerateContent)：用于提交批量 generateContent 请求的标准 REST 端点。
• 嵌入 (embedContent)：一种标准 REST 端点，可根据输入 Content 生成文本嵌入向量。
• Gen Media API：用于通过我们的专用模型（例如用于生成图片的 Imagen 和用于生成视频的 Veo）生成媒体的端点。 Gemini 还内置了这些功能，您可以使用 generateContent API 访问这些功能。
• 平台 API：支持核心功能的实用程序端点，例如上传文件和计算令牌数量。

身份验证

对 Gemini API 的所有请求都必须包含带有 API 密钥的 x-goog-api-key 标头。您可以在 Google AI Studio 中点击几下即可创建 API 密钥。

以下示例请求在标头中包含 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 密钥指南。