必须创建VPC Service Controls服务边界并配置Vertex AI访问策略、启用Private Google Access、创建Private Endpoint、授予最小IAM权限，才能在私有云中安全调用Gemini API。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在私有云环境中安全调用 Gemini API，必须切断公网路径、确保流量全程走 Google 内部骨干网，并阻止跨项目未授权访问，否则请求可能被拦截或暴露敏感数据。

创建 VPC Service Controls 服务边界

服务边界是整个防护体系的起点，不创建边界，后续所有策略都无效。

1、打开 Google Cloud Console，进入 VPC Service Controls 页面。

2、点击“创建服务边界”，输入唯一名称（如 【gemini-prod-boundary】）和描述，避免使用中文或空格。

3、在“受保护资源”中勾选当前项目；若 Gemini 调用方与模型部署分属不同项目，必须一并勾选——漏选任一项目将导致该环境调用失败。

4、在“受保护的服务”列表中，仅勾选 Vertex AI（对应服务标识 aiplatform.googleapis.com），不要勾选 Generative Language API 或其他无关服务。

5、点击创建，等待状态变为“已激活”；此过程通常需 2～5 分钟，期间任何调用都会被拒绝。

配置基于 VPC CIDR 的访问级别

边界本身不放行任何流量，必须显式定义哪些私有网段可穿透边界调用 Gemini。

方法一：基于 IP 地址范围控制

1、进入已创建边界的“访问级别”标签页 → “创建访问级别”。

2、选择条件类型为“基于 IP 地址”。

3、在“IP 地址范围”中填入目标 VPC 的完整 CIDR，例如 【10.128.0.0/16】；若只允许特定子网，填入如 10.128.10.0/24 即可，但不可写成 10.128.10.0/255.255.255.0。

4、保存后，在边界设置的“受限访问策略”中绑定该访问级别。

方法二：复用已有访问级别（仅限已存在且覆盖目标网段）

直接在边界策略中下拉选择已验证生效的访问级别，跳过新建步骤；但需确认该级别未被其他边界误用，否则策略冲突会导致调用静默失败。

启用 Private Google Access 并创建 Private Endpoint

这一步决定流量是否真正走内网——若跳过，即使边界和访问级别都配对，请求仍会尝试走公网并被拦截。

第一步：启用 Private Google Access

进入目标 VPC 的子网详情页，找到“Private Google Access”开关并设为“开启”；该操作需对每个含调用方实例的子网单独执行，不能批量设置。

第二步：创建 Private Endpoint

1、进入 Vertex AI 控制台 → “Models” → “Endpoints” → “Create endpoint”。

2、填写端点名称（如 gemini-private-ep），选择区域必须与调用方所在 VPC 区域一致。

3、关键操作：在“Network configuration”中勾选 Private endpoint，并从下拉菜单选择目标 VPC 网络。

4、点击创建，等待状态变为“Ready”；此时端点 DNS 名称（如 https://us-central1-aiplatform.googleapis.com/v1/projects/xxx/locations/us-central1/endpoints/xxx:predict）即为私有调用地址。

授予服务账号最小必要 IAM 权限

权限不足是调用返回 403 的最常见原因，必须精确授予，不能依赖项目所有者角色。

1、进入“IAM 和管理” → “IAM” → 点击右上角“添加”。

2、成员栏填入服务账号邮箱（格式为 vertex-app@your-project.iam.gserviceaccount.com）。

3、角色栏展开“Vertex AI”，选择 Vertex AI User（roles/aiplatform.user）；切勿选 Admin 或 Owner，否则违反最小权限原则。

4、保存后，等待 IAM 策略同步（通常 60 秒内生效）。

验证私有调用是否生效

验证必须从 VPC 内部发起，且使用 Private Endpoint 地址，否则无法证明策略真实生效。

1、在已启用 Private Google Access 的子网中启动一台 Compute Engine 实例。

2、安装 curl 并执行请求：
curl -X POST \
  "https://us-central1-aiplatform.googleapis.com/v1/projects/YOUR_PROJECT_ID/locations/us-central1/endpoints/YOUR_ENDPOINT_ID:predict" \
  -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  -H "Content-Type: application/json" \
  --data '{"instances": [{"content": "hello"}]}'

3、若返回 200 及有效响应体，说明私有调用链路打通；若返回 403 或连接超时，请回查边界状态、访问级别绑定、Private Endpoint 关联网络是否匹配。