LlamaCloud 支持 Google Gemini API，用简单的 API key 认证就能直连 Google 的 AI 模型。当你并不需要企业级的 Google Cloud Platform 能力时，这是相对 Google Vertex AI 更直接的一条替代路径。

前置条件

• 一个有效的 Google 账号

• 来自 Google AI Studio 的 Google Gemini API key

• 所支持模型的访问权限与配额：

  • Gemini 3.1 Pro
  • Gemini 3.0 Flash
  • Gemini 2.5 Flash
  • Gemini 2.5 Pro
  • Gemini 2.0 Flash
  • Gemini 2.0 Flash Lite

环境变量

Google Gemini API 集成使用下列环境变量：

• GOOGLE_GEMINI_API_KEY —— 你的 Google Gemini API key（必需）
• GOOGLE_GEMINI_BASE_URL —— 覆盖 Gemini API 端点（可选；默认 https://generativelanguage.googleapis.com）

配置

按下列步骤配置 Google Gemini API 集成：

第 1 步：获取 Google Gemini API key

从 Google AI Studio 取你的 API key。

第 2 步：创建 Kubernetes Secret

用你的 Google Gemini API key 创建一个 secret：

apiVersion: v1
kind: Secret
metadata:
  name: gemini-credentials
type: Opaque
stringData:
  GOOGLE_GEMINI_API_KEY: "your-api-key-here"

应用这个 secret：

终端窗口

kubectl apply -f gemini-secret.yaml

第 3 步：配置 Helm values

在你的 Helm 配置里引用这个 secret：

# External Secret
config:
  llms:
    gemini:
      secret: "gemini-credentials"
      baseUrl: "https://generativelanguage.googleapis.com"  # Optional — override endpoint

# or direct configuration
config:
  llms:
    gemini:
      apiKey: "your-api-key-here"
      baseUrl: "https://generativelanguage.googleapis.com"  # Optional — override endpoint

可选的 baseUrl / GOOGLE_GEMINI_BASE_URL 覆盖，会把 Gemini API 流量改走代理或网关（例如自托管的 LLM 网关），而不是 Google 的公网端点。留着不设则使用默认的 https://generativelanguage.googleapis.com。

验证

配置完成后，请这样验证你的 Google Gemini 集成：

1. 在管理界面核对：在 LlamaCloud 管理界面查看可用的 Google 模型

2. 测试功能：上传一份文档，确认 Gemini 模型确在工作

故障排查

常见问题

API key 无效

Error: API key not valid

解决办法：

• 确认 API key 设置正确且没有过期
• 确认这个 key 来自 Google AI Studio
• 检查该 API key 具备合适的权限

配额超限

Error: Quota exceeded

解决办法：

• 查看你在 Google AI Studio 的配额与用量上限
• 考虑升级套餐或申请提额
• 盯住 API 用量以避免被限流

模型访问问题

Error: Model not found or access denied

解决办法：

• 确认该模型在你所在地域可用
• 检查你是否有该具体模型的访问权
• 确认 API key 具备访问该模型的权限

排查步骤

1. 直接测试 Gemini API：

   终端窗口

   curl -H "Content-Type: application/json" \
        -H "x-goog-api-key: YOUR_API_KEY" \
        -d '{"contents":[{"parts":[{"text":"Hello"}]}]}' \
        "https://generativelanguage.googleapis.com/v1beta/models/gemini-pro:generateContent"

2. 确认 secret 已挂载：

   终端窗口

   kubectl get secret gemini-credentials -o yaml
   kubectl describe pod <pod-name> | grep -A 20 Environment

3. 检查网络连通性：确保你的集群能够访问 generativelanguage.googleapis.com