使用 Vertex AI

Vertex AI 认证都需要启用了 Vertex AI API 的 Google Cloud 项目，以及资源或任务运行区域：

export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"
export GOOGLE_CLOUD_LOCATION="YOUR_PROJECT_LOCATION"

PowerShell 用 $env:GOOGLE_CLOUD_PROJECT 和 $env:GOOGLE_CLOUD_LOCATION 赋值。不要把 AI Studio 的 GEMINI_API_KEY 与 Google Cloud 的 GOOGLE_API_KEY 混为同一个后端凭据。

ADC

已安装 Google Cloud CLI 时可用 Application Default Credentials。先清除会干扰选择的 API key：

unset GOOGLE_API_KEY GEMINI_API_KEY
gcloud auth application-default login
gemini

然后选择 Vertex AI。Windows 清除变量的官方方式是：

Remove-Item Env:\GOOGLE_API_KEY, Env:\GEMINI_API_KEY -ErrorAction Ignore

服务账号 JSON

适用于非交互、CI 或限制用户认证的组织。创建服务账号并分配 Vertex AI User 角色，下载 JSON 后，清除前述两个 API key 变量，并指向文件绝对路径：

export GOOGLE_APPLICATION_CREDENTIALS="/path/to/your/keyfile.json"
gemini

启动时选择 Vertex AI，项目与区域仍需设置。JSON 文件本身是凭据，应由 CI/组织的秘密管理机制保管，不能作为仓库配置提交。

Cloud API key

取得 Google Cloud API key 后设置：

export GOOGLE_API_KEY="YOUR_GOOGLE_API_KEY"
gemini

选择 Vertex AI。如果出现 API keys are not supported by this API，可能是组织限制该服务使用 key，按管理员允许的 ADC 或服务账号方式配置，而非反复更换模型名。