用途：指导在企业环境中通过 Google Cloud Vertex AI 使用 Gemini API，统一采用 Gen AI SDK。
主要能力：文本生成（对话、补全、摘要）、多模态理解（图像、音频、视频、文档）、函数调用、结构化 JSON 输出、上下文缓存、文本嵌入、Live 实时双向流式（语音与视频）、批量预测。
SDK 与安装：Python 用 pip install google-genai；JS/TS 用 npm install @google/genai；Go 用 go get google.golang.org/genai；C#/.NET 用 dotnet add package Google.GenAI；Java 使用 com.google.genai:google-genai（版本见 Sonatype）。旧版 google-cloud-aiplatform、@google-cloud/vertexai、google-generativeai 已弃用，需迁移。
认证与配置：优先用环境变量。ADC 方式设置 GOOGLE_CLOUD_PROJECT、GOOGLE_CLOUD_LOCATION（默认 global）、GOOGLE_GENAI_USE_VERTEXAI=true；Express Mode 用 GOOGLE_API_KEY 与 GOOGLE_GENAI_USE_VERTEXAI=true。客户端可不传参自动读取环境变量，也可显式传入 vertexai、project、location。
模型：复杂推理/编码/研究用 gemini-3.1-pro-preview；快速多模态用 gemini-3-flash-preview；图像生成编辑用 gemini-3-pro-image-preview；实时原生音频用 gemini-live-2.5-flash-native-audio。显式要求时可用 gemini-2.5-flash-image、gemini-2.5-flash、gemini-2.5-flash-lite、gemini-2.5-pro。gemini-2.0-、1.5-、1.0-*、gemini-pro 已弃用。生产环境应查阅 Vertex AI 文档确认稳定版本。
用法：初始化客户端后调用 generate_content/generateContent，传入模型与内容即可。API 使用 v1beta1 或 v1 REST 端点。
限制：资料未提供具体收费与价格信息；部分模型为预览版，生产使用需确认稳定版本；区域默认 global，指定区域需参考支持区域文档。