Gemini API 参考文档

此 API 参考文档介绍了可用于与 Gemini 模型交互的一元、流式和实时 API。您可以在任何支持 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 生成文本嵌入向量。
Gen Media API：用于使用我们的专用模型（例如用于生成图片的 Imagen 和用于生成视频的 Veo）生成媒体的端点。 Gemini 还内置了这些功能，您可以使用 generateContent API 访问这些功能。
平台 API：支持核心功能（例如上传文件和计算令牌）的实用程序端点。

身份验证

对 Gemini API 的所有请求都必须包含带有 API 密钥的 x-goog-api-key 标头。只需在 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 密钥指南。