biwakonbu 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