---

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 工具：

1. 获取 llms.txt 以发现可用文档页面
2. 获取特定页面（例如 https://ai.google.dev/gemini-api/docs/function-calling.md.txt）

关键文档页面

[!IMPORTANT] 这些不是所有文档页面。使用 llms.txt 索引发现可用文档页面

• 模型
• Google AI Studio 快速入门
• 图像生成
• Gemini API 函数调用
• 结构化输出
• 文本生成
• 图像理解
• 嵌入
• 交互 API
• SDK 迁移指南

适用场景

此技能适用于执行概述中描述的工作流或操作。

限制

• 仅在任务明确匹配上述范围时使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少所需输入、权限、安全边界或成功标准，请停下来要求澄清。