REST API 参考

完整的 Gemini REST API 接口文档，包含所有端点、参数和响应格式

API 基础信息

基础 URL: https://generativelanguage.googleapis.com/v1beta

认证方式: 通过 URL 参数 ?key=YOUR_API_KEY 或请求头 Authorization: Bearer TOKEN

generateContent

POST /models/{model}:generateContent

生成文本内容的主要端点。支持文本、图片、音频、视频作为输入。

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=$API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [{
      "parts": [{"text": "你好，Gemini!"}]
    }],
    "generationConfig": {
      "temperature": 0.7,
      "maxOutputTokens": 2048
    }
  }'

streamGenerateContent

POST /models/{model}:streamGenerateContent

流式生成内容，服务器会逐块返回生成的文本，适合实时对话场景。

countTokens

POST /models/{model}:countTokens

计算输入内容的 Token 数量，用于预估 API 调用成本。

embedContent

POST /models/{model}:embedContent

将文本转换为向量嵌入（Embedding），用于语义搜索、文本相似度等应用。

调试与接入建议

正式调用前，建议先在 countTokens 端点估算输入规模，避免长上下文请求超出预算。

当你需要聊天式体验时，优先评估 streamGenerateContent，它更适合前台逐字输出和低等待感交互。

如果项目已经进入正式环境，建议把认证、错误处理和安全策略与 REST 接口文档一起阅读，减少后续返工。

认证指南错误处理安全指南
开发说明

REST API 参考 在 Gemini 接入流程中的作用

REST API 参考 更适合放在完整接入链路中去理解，而不是孤立阅读。对于 Gemini API 来说，开发者通常不会只靠一页文档完成所有工作，而是需要在快速入门、认证、模型选择、错误处理、安全控制和计费规则之间不断来回对照。

当前页面所覆盖的内容，更多是在帮助你补齐某一个关键环节。完整的 Gemini REST API 接口文档，包含所有端点、参数和响应格式 如果这部分理解不够充分，前期也许能跑通，但到了业务扩容、多人协作和生产环境阶段，问题往往会逐渐放大。

阅读这类页面时，最好同时思考自己的项目状态：你是处于试验阶段、正式接入阶段，还是正在做稳定性补强。不同阶段关注的重点不同，页面里的同一段内容，在不同时间点的价值也会不同。

如果你希望当前页面的内容真正服务实际开发，建议边读边确认自己的模型、语言、部署环境和权限策略。这样再回看相关链接时，会更容易形成可执行的开发方案，而不是停留在概念层。

阅读重点

  • 单页文档更适合放回完整接入链路里理解。
  • 开发文档应服务实际项目而不是只解释名词。
  • 上线前建议把认证、异常、成本和安全一起检查。

延伸阅读

API 快速入门错误处理安全指南模型列表

阅读 REST API 参考 时可以顺手确认的细节

很多技术主题看起来像局部问题，但一旦进入真实项目，就会和模型选择、日志记录、部署环境和调用成本产生连锁关系。因此，单页文档越是基础，越值得结合整体流程去看。

如果当前主题涉及 SDK、接口格式、异常状态或鉴权方式，最好马上用自己的项目场景试着对应一遍。这样可以更快发现还有哪些缺口需要回到其他文档补齐。

对于正式商用场景，建议把文档中的默认用法进一步改造成符合自己环境的实现，例如更明确的重试策略、密钥隔离和监控记录。这样更接近长期可维护的接入方式。

看上下游关系

当前页面通常只是开发链路中的一个节点，前后内容往往同样关键。

看实际环境

浏览器试验、服务端接入和企业环境，对同一主题的要求并不完全相同。

看后续维护

越早把异常处理和权限边界想清楚，后面越容易稳定扩展。