用途：本资料是 Google Gemini API 的完整使用指南，面向需要调用 Gemini 模型的开发者，重点说明应使用当前 SDK @google/genai v1.27+，而非已弃用的 @google/generative-ai（计划于 2025 年 11 月 30 日停用）。
主要能力：涵盖文本生成（基础与流式）、多模态输入（图像、视频、音频、PDF）、函数调用（基础与并行）、系统指令与多轮对话、思考模式配置、生成参数（temperature、top-p、top-k、停止序列）；进阶部分包括上下文缓存（基于 TTL 的成本优化）、代码执行（内置 Python 解释器与沙箱）、Google 搜索接地（实时网络信息与引用）。嵌入模型另见 google-gemini-embeddings 技能。
模型：Gemini 2.5 系列含 gemini-2.5-pro、gemini-2.5-flash、gemini-2.5-flash-lite，均支持思考模式（默认开启）、函数调用、多模态与流式，输入上下文 1,048,576 tokens、输出上限 65,536 tokens，知识截止 2025 年 1 月。资料特别纠正：2.5 系列上下文为 1,048,576 tokens，并非 2M（2M 仅属上一代 Gemini 1.5 Pro）。
使用方式：安装 npm install @google/genai@1.27.0，设置环境变量 GEMINI_API_KEY。可用 Node.js SDK（类型安全、内置聊天助手、自动 SSE 解析）或直接 fetch REST 接口（适用于 Cloudflare Workers、Deno、Bun、浏览器等边缘环境）。流式需使用 streamGenerateContent 端点并解析 SSE 格式。
限制：图像单张最大 20MB，音频最大 20MB，PDF 最大 30MB（扫描件准确率可能较低），内联视频最长 2 分钟、最大 2GB（更大文件需 File API）。资料还包含错误处理、速率限制、SDK 迁移指南与生产实践等章节。