gemini-api skill 是什麼、怎麼安裝使用：Google 官方的 Gemini API 開發 Skill（Agent Platform / 原 Vertex AI）

本文根據 google/skills 倉庫裏該技能的 SKILL.md 與倉庫 README 整理，資料核對於 2026-10-11。所在倉庫 google/skills 在 GitHub 約 2.1 萬 Star（同日數據）。技能內容會隨倉庫更新，以倉庫為準。

這個 Skill 做什麼

Google 的 AI 平台改名頻繁，SDK 也換過代，模型憑舊記憶寫出來的 Gemini 調用代碼經常用的是已經過時的庫。gemini-api 技能給出當前的正確寫法。它開頭就有一條重要提示：Agent Platform（全稱 Gemini Enterprise Agent Platform）就是以前的 Vertex AI，網上大量資料仍沿用舊名。

description：當用戶詢問在企業環境中使用 Gemini，或明確提到 Vertex AI、Google Cloud、Agent Platform 時使用；指導通過 Google Gen AI SDK 使用 Agent Platform 上的 Gemini API；覆蓋 SDK 用法（Python、JS/TS、Go、Java、C#），以及多模態輸入、工具、媒體生成、緩存、批量預測和 Live API 等能力。兼容性一欄寫明：需要有效的 Google Cloud 憑據，並已啟用 Agent Platform API。

內容包括：核心指令、各語言的 SDK、認證與配置（應用預設憑據，以及更簡單的 Express 模式）、初始化、模型選擇、五種語言的快速上手代碼，並指明以 API 規範和官方文檔為事實來源。更細的主題放在九份參考文件裏：文本與多模態、結構化輸出與工具、嵌入、媒體生成、Live API、模型調優、安全設定、高級特性、邊界框。

怎麼安裝

倉庫 README 的安裝方式是 npx skills add google/skills。這個庫有一百多個技能，建議用 skills CLI 的 --skill 參數只裝需要的：

bash
npx skills add google/skills --skill gemini-api

Claude Code 也可以按插件安裝：claude plugin marketplace add google/skills，再 claude plugin install <插件名>@google-plugins（插件劃分見倉庫的市場清單）。

倉庫整體介紹和其他安裝方式，詳見本站《google/skills 是什麼、怎麼安裝：Google 官方 Agent Skills 倉庫（Google Cloud、BigQuery、GKE、Gemini API、廣告 SDK）》。

怎麼用

• 「用 Python 寫一個調用 Gemini 分析圖片的腳本，走 Google Cloud 的認證」。
• 「把這段用舊版 Vertex AI SDK 的代碼遷移到 Google Gen AI SDK」。
• 「加上函數調用和上下文緩存」。

適合誰 / 侷限

適合在 Google Cloud 上做企業級 Gemini 應用的開發者。注意它面向的是雲平台上的企業用法；只是用 AI Studio 的個人 API Key 做小項目的話，流程更簡單，未必需要這個技能。模型名稱與可用區域變化快，以官方文檔為準。

注意事項

• 許可：Apache-2.0。
• 憑據與費用：需要 Google Cloud 項目和憑據，調用按 Google Cloud 的價格計費；憑據用官方的登入方式配置，不要把密鑰文件提交進倉庫或貼進對話。
• 不執行腳本；按說明會去查閱官方文檔。
• 國內網絡環境訪問 Google Cloud 接口可能受限，屬於網絡層面的問題。