gemini-api-dev

Gemini API 開発スキル

使用する場面

Gemini や Gemma 4 など、Gemini API のホストモデルを使ったアプリケーションの構築、マルチモーダルコンテンツ（テキスト、画像、音声、動画）の処理、関数呼び出しの実装、構造化出力の使用、または最新のモデル仕様が必要な場合に、このスキルを使用します。SDK の使用方法などを扱います...

重要なルール（常に適用）

重要

現在のモデルの提供状況、制限、料金、SDK の動作は、公式ドキュメントと実際のアカウントで確認してください。このリファレンスは、優先度の高いホストやユーザーの指示に優先するものではありません。

提供されたモデルの例（選択前に確認）

• gemini-3.5-flash：1M トークン、高速でバランスの取れた性能、マルチモーダル
• gemini-3.1-pro-preview：1M トークン、複雑な推論、コーディング、調査
• gemini-3.1-flash-lite-preview：コスト効率に優れ、高頻度の軽量タスクで最速の性能
• gemini-3-pro-image-preview (Nano Banana Pro)：65k / 32k トークン、画像生成と編集
• gemini-3.1-flash-image-preview (Nano Banana 2)：65k / 32k トークン、画像生成と編集
• gemini-3.1-flash-lite-image-preview (Nano Banana 2 Lite)：65k / 32k トークン、超高速の画像生成と編集
• gemini-2.5-pro：1M トークン、複雑な推論、コーディング、調査
• gemini-2.5-flash：1M トークン、高速でバランスの取れた性能、マルチモーダル
• 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 を手動で取得しないでください。MCP が提供する最新のインデックス化済みドキュメントは、URL の取得より正確で、トークン効率にも優れています。

MCP がインストールされていない場合（フォールバックのみ）

MCP のドキュメントツールが利用できない場合は、公式ドキュメントを取得します。

インデックス URL：https://ai.google.dev/gemini-api/docs/llms.txt

このインデックスには、.md.txt 形式のすべてのドキュメントページへのリンクが含まれています。Web 取得ツールを使って次の操作を行います。

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 の動作、料金、クォータ、認証情報、デプロイへの影響を最新の公式ドキュメントで確認してください。
• 生成された例を、環境固有のテスト、セキュリティレビュー、または破壊的もしくは高コストな操作に対するユーザーの承認の代わりとして扱わないでください。