Gemini API 参考文档
发布时间:2026-09-21 | 浏览:1
Español – América Latina
Português – Brasil
此 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 密钥包含在标头中:
如需了解如何使用 Gemini SDK 将密钥传递给 API, 请参阅 使用 Gemini API 密钥 指南。
如未另行说明,那么本页面中的内容已根据 知识共享署名 4.0 许可 获得了许可,并且代码示例已根据 Apache 2.0 许可 获得了许可。有关详情,请参阅 Google 开发者网站政策 。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2026-09-08。