用途
该技能用于指导开发者编写调用 Gemini API 的代码，覆盖文本生成、多轮聊天、多模态理解、图像生成、视频生成、语音合成、嵌入以及托管智能体等任务。资料以“关键规则”的形式列出了当前可用模型、智能体与 SDK 版本，并强调这些规则优先于模型训练数据中的过时知识。
主要能力与当前模型
资料列出的当前模型包括：gemini-4-argon（100 万 token，最强复杂推理、编码与研究）、gemini-3.8-flash（100 万 token，面向智能体与多模态任务的快速均衡模型）、gemini-3.5-flash-lite（最快、低成本的 3.5 模型）、gemini-3.1-flash-lite（高频轻量任务）、gemini-3.5-transcribe（语音转文本，支持 smart 与 verbatim 模式）、gemini-nano-banana-2.1（默认高效图像生成与对话式编辑）、gemini-3-pro-image（高质量图像生成与编辑）、gemini-3.1-flash-lite-image（超快图像生成与编辑）、gemini-3.8-flash-tts（表现力 TTS、多说话人对话、Voice Design 与 Voice Replication）、gemini-3.8-flash-lite-tts（快速低成本 TTS）、gemini-omni-1.1-flash（视频生成、首帧转视频、首尾帧过渡、视频扩展最多 40 秒、视频编辑与参考引导生成）、gemma-4-31b-it、gemma-4-26b-a4b-it，以及 gemini-embedding-2（多模态嵌入）与 gemini-embedding-001（纯文本嵌入）。
资料明确警告 gemini-2.5-、gemini-2.0-、gemini-1.5-* 属于旧版并已弃用，不应使用；若用户要求已弃用模型，应改用 gemini-3.8-flash 并说明替换。
当前智能体与 SDK
智能体包括 antigravity-preview-09-2026（通用托管智能体，可在沙盒 Linux 环境中执行代码、管理文件与访问网络）、deep-research-preview-04-2026（快速交互式研究）与 deep-research-max-preview-04-2026（最大详尽度研究），也可通过 client.agents.create() 创建自定义智能体。
SDK 方面：Python 使用 google-genai >= 2.30.1，安装命令为 pip install -U google-genai；JavaScript/TypeScript 使用 @google/genai >= 2.29.1，安装命令为 npm install @google/genai。资料说明 2.0.0 及以上版本自动使用新的 steps schema，不支持旧 schema；旧版 google-generativeai（Python）与 @google/generative-ai（JS）已弃用。
使用方式
资料要求写代码前必须获取与任务匹配的官方文档页面；若安装了 Gemini Docs MCP（https://gemini-api-docs-mcp.dev），应优先使用 gemini_search_docs / gemini_get_doc 作为唯一文档来源，不再手动抓取 URL。未安装 MCP 时，以 https://ai.google.dev/gemini-api/docs/llms.txt 为权威文档入口，并抓取对应页面。
快速开始示例使用 client.interactions.create 并读取 interaction.output_text。状态化对话通过 previous_interaction_id 让服务端记住上下文。响应对象提供 output_text、output_image、output_audio 等便捷属性。流式响应设置 stream=True，事件顺序为 interaction.created → (step.start → step.delta → step.stop)+ → interaction.completed。Deep Research 智能体需要 background=True 并轮询状态。托管智能体需要 environment="remote"（或环境 ID / 配置对象）来分配沙盒；自定义智能体通过 client.agents.create 定义，并可配合 base_environment 挂载代码仓库。
注意事项与限制
资料说明交互默认会被存储（Python store=True，TypeScript store: true），付费层保留 55 天，免费层保留 1 天；设置 store=False 可退出，但会禁用 previous_interaction_id 与 background=True。tools、system_instruction 与 generation_config 是交互作用域参数，每轮都需要重新指定。从 generateContent 迁移、模型升级以及迁移到 Gemini 3.8 TTS、Nano Banana 2.1 等需阅读 references/migration.md，并在编辑前与用户确认范围。托管智能体的能力、工具、多模态输入与价格需查阅对应文档。资料未提供具体收费价格、性能基准或配额信息。
适用场景
适用于需要以 Gemini API 构建文本生成、多轮对话、多模态分析、图像/视频/语音生成、嵌入检索以及托管智能体工作流的开发场景。