1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | gemini-api-google-skills(合集仓库 google/skills 内的子技能) |
| 作者/维护方 | Google(google 官方 GitHub 组织) |
| 来源链接 | https://github.com/google/skills/tree/main/skills/cloud/gemini-api |
| 许可证 | Apache-2.0(GitHub API 实测,仓库级) |
| GitHub Stars | 18,698(GitHub API 实测;为合集仓库整体数据,非本技能单独热度) |
| Forks | 1,499(同上,合集仓库整体数据) |
| 最新版本 | 无独立 Release/Tag,随 main 分支滚动更新(实测最近一次内容提交 2026-07-21) |
| 安装方式 | npx skills add google/skills(安装时选择 gemini-api 子技能) |
2. 功能介绍与亮点
核心能力:文本生成/对话、多模态理解(图像/音频/视频/文档)、函数调用(Function Calling)、结构化输出(JSON Schema)、上下文缓存、文本 Embedding、Live 实时双向流式(语音/视频)、批量预测(Batch Prediction)。
亮点:
① 五语言 SDK 覆盖:Python/JS-TS/Go/Java/C# 均提供可直接复制运行的 Quick Start 代码;
② 结构化程度高:主指南(10.2KB)之外另附 9 篇分主题参考文档(内容缓存、Embedding、结构化输出与工具、媒体生成、目标检测、Live API、高级特性、安全过滤、模型微调),按需索引,不占用主上下文;
③ 明确的模型选型与弃用提示:区分优先推荐模型(如 gemini-3.1-pro-preview、gemini-3.6-flash)与仅在用户明确要求时才使用的旧模型,避免编程助手因训练数据过时而误用已弃用接口;
④ 维护活跃:最近一次更新(2026-07-21)同步补充了新发布模型的调用方式。
3. 适用场景
所属分类:工程效率与代码质量。
面向在 Google Cloud / Vertex AI(现更名为 Gemini Enterprise Agent Platform)环境中用编程助手开发应用的开发者与团队,尤其适合需要在企业 GCP 项目内(带 IAM 权限管控)调用 Gemini 模型完成文本生成、多模态理解、结构化输出,或搭建实时语音/视频交互功能的场景;也适合希望编程助手掌握最新模型名称与 SDK 用法、避免误用已弃用接口的团队。
4. 跨 Agent 兼容性
仓库通过 npx skills add(skills.sh 官方安装器)分发,该安装器官方支持列表明确包含 Claude Code、Codex、OpenClaw 与 Hermes Agent(各自带专用适配路径)。
- Claude Code:✅ 原生支持
- Codex:✅ 原生支持(skills.sh 安装器官方支持)
- OpenClaw:✅ 原生支持(skills.sh 安装器官方支持)
- Hermes Agent:✅ 原生支持(skills.sh 安装器官方支持)
5. 推荐理由
Gemini API 的模型与 SDK 版本迭代频繁,若编程助手依赖过时的训练数据,容易写出调用已弃用模型或旧版 SDK 的代码。该技能由 Google 官方维护,明确列出当前推荐模型与弃用模型清单、统一五语言 SDK 规范,并将高级功能拆分为 9 篇按需加载的参考文档,兼顾主文档的简洁与覆盖深度,且在近一个月内仍持续更新。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Google 官方一线厂商出品;所属 google/skills 合集仓库整体 18,698 stars / 1,499 forks(GitHub API 实测),但合集 stars 不计入单个子技能自身热度,本技能目前也尚无可归因于它自身的独立第三方证据 |
| 可用性 | 9 | 覆盖 Python/JS-TS/Go/Java/C# 五语言、可直接复制运行的 Quick Start 代码;正文外另附 9 篇分主题参考文档;最近一次内容更新为 2026-07-21,一个月内 |
| 安全性 | 9 | 无 shell 命令执行(仅指导安装官方 SDK 包);网络请求全部指向 Google 自有 API 端点,无第三方外发;凭据通过标准环境变量(ADC/API Key)传递,SDK 不在本地明文落盘;仓库 Apache-2.0 许可、Google 官方组织托管;未发现可疑指令 |
安全检查清单:①无 shell 命令执行,仅涉及 pip/npm/go get 等标准包管理器安装指令 ②网络请求均指向 Google 自有 *.googleapis.com / docs.cloud.google.com 端点,无第三方外发 ③需要 Google Cloud 凭据(Application Default Credentials 或 API Key),通过环境变量传递,SDK 不在本地明文存储 ④正文与 9 篇参考文档逐一审阅,未发现隐藏指令或 prompt injection 迹象 ⑤Google 官方(google)组织托管,信誉良好 ⑥仓库 License 为 Apache-2.0,明确开源 ⑦最近一次功能更新 2026-07-21,一个月内,维护活跃
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
| gemini-api-dev-google-gemini-gemini-skills | google-gemini 官方仓库,面向 Gemini Developer API(AI Studio,简单 API Key 鉴权)的多语言 SDK 指南 |
服务面向个人开发者的公开 Gemini API,鉴权与模型清单独立维护;本技能服务企业 GCP 项目内(IAM/ADC 鉴权)的 Agent Platform 场景,二者是 Google 两条并行产品线 |
| gemini-interactions-api(同仓库) | 聚焦新一代有状态 Interactions API,支持多轮对话与后台执行 | 是本技能之外的另一套调用范式(有状态 vs. 本技能的无状态 generateContent),官方定位为“现代推荐方式”,与本技能可搭配使用而非互斥 |
| genkit-go-google-skills | Google 官方 Genkit 应用开发框架的 Go 语言指南,用于搭建含流程编排、评测的完整 AI 应用 | 是更高层的应用框架而非直接 SDK 调用,适合需要流程编排/评测能力的完整应用开发;本技能更适合直接调用模型 API 的轻量场景 |
| copilot-sdk-microsoft-skills | Microsoft 官方 Copilot SDK 开发指南 | 服务 Copilot SDK 生态而非 Gemini 生态,同属厂商官方 SDK 指南类技能 |
8. 用户评价
该技能所属的 google/skills 仓库于 2026 年 Google Cloud Next 大会发布后,获得第三方技术媒体报道:Pinggy Blog 撰文介绍该仓库覆盖 BigQuery、GKE、Cloud Run、Gemini API 等 Google Cloud 与 Workspace 产品线,以 Apache-2.0 协议开源,可与 Claude Code、Antigravity CLI 等多种编程助手配合使用;文章同时提到接入 Google 官方“Gemini API Docs MCP”后,编程助手完成 Gemini API 相关任务的正确率由 28.2% 提升至 96.6%(该数据针对配套 MCP 工具本身,非本 SKILL.md 技能的实测结果)。
本技能(gemini-api)自身目前在第三方平台尚无独立具名用户评价。
9. 其他补充
同一仓库内另有 gemini-agents-api(Managed Agents 控制面 API)与 gemini-live-api(Live 实时语音视频客户端生成)两个姊妹技能,覆盖不同调用范式,可按需单独安装。
10. 安装使用方式
渠道:
① skills.sh 官方安装器:npx skills add google/skills,交互式勾选 gemini-api 子技能;
② 手动安装:克隆仓库后将 skills/cloud/gemini-api/ 整个目录(含 SKILL.md 与 references/ 子目录)复制到编程助手的技能目录(如 .claude/skills/)。
安装后无需重启;任务涉及在 Google Cloud/Agent Platform 环境调用 Gemini 模型时按需触发;使用前需自行配置 Google Cloud 凭据(设置 GOOGLE_CLOUD_PROJECT/GOOGLE_CLOUD_LOCATION 环境变量走标准 ADC 鉴权,或在 Express Mode 下配置 GOOGLE_API_KEY)。
11. 注意事项
- 服务对象是 Google Cloud/Vertex AI 企业环境(现更名 Gemini Enterprise Agent Platform),与面向个人开发者的 Gemini Developer API(AI Studio)鉴权方式不同,装错产品线的技能会导致鉴权失败。
- Gemini API 为付费按量计费服务,需自备可用的 Google Cloud 项目与结算账号。
- 仓库无独立版本号/Release 标签,内容随 main 分支滚动更新,模型清单可能随时间变化,建议定期关注仓库更新。