gemini-api-overview

name	gemini-api-overview
description	Use when user asks about Gemini API overview, model selection, which Gemini model to use, Gemini model comparison, or SDK setup. Also use when user says Gemini API について, モデル選択, どのモデルを使うべき, Gemini SDK. Gemini API の全体概要、モデルファミリー一覧、用途別推奨モデル早見表、SDK 基本使用法を提供する。
context	fork

Gemini API Overview

Gemini API の全体像とモデル選択ナビゲーション。

---

モデルファミリー一覧

Gemini 3.1 系（最新・推奨）

モデル	モデル ID	特徴	推奨用途
3.1 Pro	gemini-3.1-pro-preview	最高性能、推論モード対応	高精度タスク、複雑な分析
3.1 Flash	gemini-3.1-flash-preview	コスト効率と性能のバランス	汎用推奨
3.1 Flash Lite	gemini-3.1-flash-lite-preview	最速・最安	大量処理・基本利用推奨

Gemini 3.0 系

モデル	モデル ID	状態
3.0 Pro	gemini-3-pro	安定版（3.1 Pro への移行推奨）
3.0 Flash	gemini-3-flash	安定版（3.1 Flash への移行推奨）

特殊用途モデル

モデル	モデル ID	用途
Nano Banana 2	gemini-3-flash-image-preview	画像生成（Flash ベース、高速）
Nano Banana Pro	gemini-3-pro-image-preview	画像生成（Pro ベース、高品質）
Veo 3.1	veo-3.1	動画生成
Chirp 3	chirp-3	音声認識・TTS 専用

レガシーモデル（非推奨）

• Gemini 2.5 Pro / Flash → 3.0 以降に移行すべき
• Gemini 2.0 以前 → サポート終了予定

---

用途別推奨モデル早見表

用途	コスト優先	パフォーマンス優先
チャット・QA	Flash Lite	Flash
コード生成	Flash	Pro
文書要約	Flash Lite	Flash
データ分析	Flash	Pro
推論・数学	Flash（thinking）	Pro（thinking）
画像生成	Nano Banana 2	Nano Banana Pro
音声・TTS	Flash Live	Pro Live
動画生成	Veo 3.1（短尺）	Veo 3.1（4K）
翻訳	Flash Lite	Flash
マルチモーダル入力	Flash	Pro

---

SDK 基本使用法

Python

from google import genai

client = genai.Client(api_key="YOUR_API_KEY")

# テキスト生成
response = client.models.generate_content(
    model="gemini-3.1-flash-preview",
    contents="Hello, Gemini!"
)
print(response.text)

Node.js

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({ apiKey: "YOUR_API_KEY" });

// テキスト生成
const response = await ai.models.generateContent({
  model: "gemini-3.1-flash-preview",
  contents: "Hello, Gemini!",
});
console.log(response.text);

REST API

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.1-flash-preview:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -d '{"contents": [{"parts": [{"text": "Hello, Gemini!"}]}]}'

---

認証方法

方法	用途	設定
API キー	個人開発・プロトタイプ	GEMINI_API_KEY 環境変数
OAuth 2.0	ユーザー認証が必要なアプリ	Google Cloud Console で設定
サービスアカウント	サーバーサイド・本番環境	Vertex AI 経由

AI Studio vs Vertex AI

項目	AI Studio	Vertex AI
認証	API キー	サービスアカウント / OAuth
無料枠	あり	なし（課金必須）
SLA	なし	あり
リージョン	グローバル	リージョン指定可
エンタープライズ機能	限定的	フル

---

コンテキストウィンドウ

モデル	入力上限	出力上限
3.1 Pro	2M トークン	65K トークン
3.1 Flash	1M トークン	65K トークン
3.1 Flash Lite	1M トークン	32K トークン

---

関連スキル参照

• テキストモデルの詳細 → gemini-text-models
• 画像生成 → gemini-image-generation
• 音声・TTS → gemini-audio-tts
• 動画生成 → gemini-video-generation
• 価格・レート制限 → gemini-api-pricing