成功集成 Google Gemini Pro API 需依次完成：一、在 Google Cloud 创建项目并启用 Vertex AI Gemini API；二、生成 API 密钥或服务账号密钥并授予权限；三、构造含正确 URL、Authorization/Content-Type 头及 JSON 请求体的 HTTPS POST 请求；四、用 curl 验证响应；五、Python 中用 requests 调用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在自己的应用程序中集成 Google Gemini Pro API，但尚未完成环境配置与身份验证设置，则可能是由于 API 密钥未正确生成或请求头未按规范构造。以下是完成 Google Gemini Pro API 开发起步与鉴权的步骤：
一、获取 Google Cloud 项目与启用 Gemini API
必须在一个有效的 Google Cloud 项目中启用 Gemini API，否则所有请求将返回 403 或 404 错误。该步骤为调用 API 的前提条件，确保服务已激活且配额可用。
1、访问 https://console.cloud.google.com/ 并使用 Google 账户登录。
2、在顶部项目选择器中，点击“新建项目”，输入项目名称并创建。
3、进入新项目后，在左侧导航栏点击“API 和服务”→“库”，在搜索框中输入 Gemini API。
4、在搜索结果中点击 Vertex AI Gemini API（注意非旧版 “Generative Language API”），点击“启用”按钮。
二、创建 API 密钥或服务账号密钥
Google Gemini Pro API 支持两种鉴权方式：简单场景使用 API 密钥，生产环境推荐使用服务账号密钥。二者不可混用，且密钥权限范围需严格匹配调用需求。
1、若选用 API 密钥：进入“API 和服务”→“凭据”，点击“创建凭据”→“API 密钥”，复制生成的密钥字符串。
2、若选用服务账号密钥：在“凭据”页点击“创建凭据”→“服务账号密钥”，选择已有或新建服务账号，密钥类型选 JSON，点击“创建”并自动下载文件。
3、为服务账号授予必要角色：在“IAM 和管理”→“IAM”中，找到对应服务账号，点击编辑图标，添加角色 Vertex AI User 和 Service Usage Consumer。
三、构造符合要求的 HTTP 请求头与请求体
Gemini Pro API 仅接受 HTTPS POST 请求，且必须携带正确的认证头与内容类型声明。请求体格式必须为 JSON，且模型名称需精确匹配官方支持值。
1、设置请求 URL 为：https://generativelanguage.googleapis.com/v1beta/models/gemini-pro:generateContent?key=YOUR_API_KEY（若使用 API 密钥）。
2、若使用服务账号密钥，需先通过私钥生成 OAuth 2.0 访问令牌，再在请求头中添加：Authorization: Bearer ya29.a0...。
3、请求头中必须包含：Content-Type: application/json。
4、请求体示例（纯文本输入）：{"contents":[{"parts":[{"text":"你好"}]}]}。
四、验证鉴权是否生效的最小可行请求
使用 curl 或 Postman 发送最简请求，可快速确认密钥有效性与网络可达性。该测试不依赖 SDK，排除客户端封装干扰。
1、执行以下命令（将 YOUR_API_KEY 替换为实际密钥）：curl -X POST "https://generativelanguage.googleapis.com/v1beta/models/gemini-pro:generateContent?key=YOUR_API_KEY" -H "Content-Type: application/json" -d '{"contents":[{"parts":[{"text":"Hello"}]}]}'。
2、若返回包含 candidates 字段的 JSON 响应，说明鉴权成功。
3、若返回 400 Bad Request，检查请求体 JSON 格式；若返回 403 Forbidden，确认 API 已启用且密钥未被限制 IP 或应用限制。
五、在代码中集成 API 调用（Python 示例）
直接使用标准 HTTP 库调用可避免 SDK 版本兼容问题，适用于快速验证逻辑。该方式不依赖 google-generativeai 包，降低环境依赖复杂度。
1、安装 requests 库：pip install requests。
2、编写 Python 脚本，设置 API 密钥变量：API_KEY = "your_api_key_here"。
3、构造请求字典并发送 POST：response = requests.post(f"https://generativelanguage.googleapis.com/v1beta/models/gemini-pro:generateContent?key={API_KEY}", headers={"Content-Type": "application/json"}, json={"contents": [{"parts": [{"text": "解释量子纠缠"}]}]})。
4、打印响应内容：print(response.json())。
