gemini-api-dev

Gemini API 开发技能

使用时机

在使用 Gemini API 托管模型构建应用时，使用此技能，包括 Gemini 和 Gemma 4；处理多模态内容（文本、图像、音频、视频）；实现函数调用；使用结构化输出；或需要查询当前模型规格。涵盖 SDK 用法……

关键规则（始终适用）

重要

请根据官方文档和实际账号，核实当前模型的可用性、限制、定价和 SDK 行为。本参考不能覆盖优先级更高的宿主或用户指令。

贡献的模型示例（选择前请核实）

• gemini-3.5-flash：1M 个 token，速度快、性能均衡，支持多模态
• gemini-3.1-pro-preview：1M 个 token，适用于复杂推理、编码和研究
• gemini-3.1-flash-lite-preview：高性价比，速度最快，适用于高频、轻量级任务
• gemini-3-pro-image-preview (Nano Banana Pro)：65k / 32k 个 token，用于图像生成和编辑
• gemini-3.1-flash-image-preview (Nano Banana 2)：65k / 32k 个 token，用于图像生成和编辑
• gemini-3.1-flash-lite-image-preview (Nano Banana 2 Lite)：65k / 32k 个 token，用于超快速图像生成和编辑
• gemini-2.5-pro：1M 个 token，适用于复杂推理、编码和研究
• gemini-2.5-flash：1M 个 token，速度快、性能均衡，支持多模态
• gemma-4-31b-it：Gemma 4 稠密模型，31B 个参数
• gemma-4-26b-a4b-it：Gemma 4 MoE 模型，总计 26B 个参数，其中 4B 个为激活参数

警告

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
• Java：com.google.genai:google-genai（见下文 Maven/Gradle 配置）

注意

旧版 SDK google-generativeai（Python）和 @google/generative-ai（JS）已弃用。切勿使用。

---

快速入门

Python

from google import genai

client = genai.Client()
response = client.models.generate_content(
    model="gemini-3.5-flash",
    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.5-flash",
  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.5-flash", genai.Text("Explain quantum computing"), nil)
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println(resp.Text)
}

Java

import com.google.genai.Client;
import com.google.genai.types.GenerateContentResponse;

public class GenerateTextFromTextInput {
  public static void main(String[] args) {
    Client client = new Client();
    GenerateContentResponse response =
        client.models.generateContent(
            "gemini-3.5-flash",
            "Explain quantum computing",
            null);

    System.out.println(response.text());
  }
}

Java 安装：

• 最新版本：https://central.sonatype.com/artifact/com.google.genai/google-genai/versions
• Gradle：implementation("com.google.genai:google-genai:${LAST_VERSION}")
• Maven：

  <dependency>
      <groupId>com.google.genai</groupId>
      <artifactId>google-genai</artifactId>
      <version>${LAST_VERSION}</version>
  </dependency>
  

---

文档查询

已安装 MCP 时（首选）

如果可以使用 Google MCP 服务提供的 search_docs 工具，请将其作为唯一的文档来源：

1. 使用查询内容调用 search_docs
2. 阅读返回的文档
3. 检查来源 URL、修订版本和检索日期；已索引的 MCP 文档可能滞后或不完整。若存在冲突，请以官方提供方文档为准。

重要

存在 MCP 工具时，切勿手动获取 URL。与通过 URL 获取相比，MCP 提供的索引文档更新、更准确，且更节省 token。

未安装 MCP 时（仅作后备方案）

如果没有可用的 MCP 文档工具，请从官方文档获取：

索引 URL：https://ai.google.dev/gemini-api/docs/llms.txt

此索引包含所有文档页面的链接，格式为 .md.txt。使用网页获取工具执行以下操作：

1. 获取 llms.txt，以查找可用页面
2. 获取具体页面（例如，https://ai.google.dev/gemini-api/docs/function-calling.md.txt）

重要页面：

• 文本生成
• 函数调用
• 结构化输出
• 图像生成
• 图像理解
• 嵌入
• SDK 迁移指南

---

Gemini Live API

如需使用 Gemini Live API 实现实时、双向的音频/视频/文本流式传输，请安装 google-gemini/gemini-live-api-dev 技能。它涵盖 WebSocket 流式传输、语音活动检测、原生音频功能、函数调用、会话管理、临时令牌等。

限制

• 仅当任务明确匹配其上游产品或 API 范围时，才使用此技能。
• 在做出更改前，请根据当前官方文档核实命令、API 行为、定价、配额、凭据和部署效果。
• 不要将生成的示例视为环境特定测试、安全审查或针对破坏性或有成本操作的 用户批准的替代品。