
关于
Gemini API 提供对 Google 最先进 AI 模型的访问。主要功能包括多模态理解、长上下文处理、代码生成和函数调用。
name: gemini-api-dev description: "Gemini API 提供对 Google 最先进 AI 模型的访问。主要功能包括文本生成、多模态理解、函数调用、结构化输出、代码执行、上下文缓存和嵌入。" risk: unknown source: community date_added: "2026-02-27"
Gemini API 开发技能
概述
Gemini API 提供对 Google 最先进 AI 模型的访问。主要功能包括:
- 文本生成 - 对话、补全、摘要
- 多模态理解 - 处理图像、音频、视频和文档
- 函数调用 - 让模型调用你的函数
- 结构化输出 - 生成匹配你 schema 的有效 JSON
- 代码执行 - 在沙箱环境中运行 Python 代码
- 上下文缓存 - 缓存大型上下文以提高效率
- 嵌入 - 生成文本嵌入用于语义搜索
当前 Gemini 模型
gemini-3-pro-preview:1M tokens,复杂推理、编码、研究gemini-3-flash-preview:1M tokens,快速、平衡性能、多模态gemini-3-pro-image-preview:65k / 32k tokens,图像生成和编辑
[!IMPORTANT]
gemini-2.5-*、gemini-2.0-*、gemini-1.5-*等模型已过时和弃用。请使用上述新模型。你的知识可能已过时。
SDK
- Python:
google-genai安装命令pip install google-genai - JavaScript/TypeScript:
@google/genai安装命令npm install @google/genai - Go:
google.golang.org/genai安装命令go get google.golang.org/genai
[!WARNING] 旧版 SDK
google-generativeai(Python)和@google/generative-ai(JS)已弃用。请按照迁移指南紧急迁移到上述新 SDK。
快速开始
Python
from google import genai
client = genai.Client()
response = client.models.generate_content(
model="gemini-3-flash-preview",
contents="Explain quantum computing"
)
print(response.text)
JavaScript/TypeScript
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({});
const response = await ai.models.generateContent({
model: "gemini-3-flash-preview",
contents: "Explain quantum computing"
});
console.log(response.text);
Go
package main
import (
"context"
"fmt"
"log"
"google.golang.org/genai"
)
func main() {
ctx := context.Background()
client, err := genai.NewClient(ctx, nil)
if err != nil {
log.Fatal(err)
}
resp, err := client.Models.GenerateContent(ctx, "gemini-3-flash-preview", genai.Text("Explain quantum computing"), nil)
if err != nil {
log.Fatal(err)
}
fmt.Println(resp.Text)
}
API 规范(权威来源)
始终使用最新的 REST API 发现规范作为 API 定义的权威来源(请求/响应 schema、参数、方法)。在实现或调试 API 集成时获取规范:
- v1beta(默认):
https://generativelanguage.googleapis.com/$discovery/rest?version=v1beta除非集成明确固定在 v1,否则使用此版本。官方 SDK(google-genai、@google/genai、google.golang.org/genai)目标为 v1beta。 - v1:
https://generativelanguage.googleapis.com/$discovery/rest?version=v1仅当集成明确设置为 v1 时使用。
如有疑问,使用 v1beta。参考规范获取确切的字段名、类型和支持的操作。
如何使用 Gemini API
获取详细 API 文档,请从官方文档索引获取:
llms.txt URL:https://ai.google.dev/gemini-api/docs/llms.txt
此索引包含所有文档页面的 .md.txt 格式链接。使用 web fetch 工具:
- 获取
llms.txt以发现可用文档页面 - 获取特定页面(例如
https://ai.google.dev/gemini-api/docs/function-calling.md.txt)
关键文档页面
[!IMPORTANT] 这些不是所有文档页面。使用
llms.txt索引发现可用文档页面
适用场景
此技能适用于执行概述中描述的工作流或操作。
限制
- 仅在任务明确匹配上述范围时使用此技能。
- 不要将输出视为环境特定验证、测试或专家审查的替代品。
- 如果缺少所需输入、权限、安全边界或成功标准,请停下来要求澄清。
兼容工具
Claude CodeCursor
标签
AI与机器学习