◉GEMINI LABEN
●ARGON — gemini-4-argon が 10/13 に GA。複雑なコーディング・エージェント・数学・科学向けです●DEEP RES — deep-research-pro-preview-12-2025 は 10/23 に停止、残り6日。移行先は deep-research-preview-04-2026●NANO — gemini-nano-banana-2.1 が GA(10/06)。gemini-3.1-flash-image は非推奨で停止日は未発表です●MCP — ツール結果が 8.5万トークンに膨らんだ事例を、ADK で 310 トークンに包んで抑えた報告が出ています●FLASH — gemini-3.7-flash と 3.5-flash は新しい Flash モデルに自動で回されます(10/08)●NEW — クラッシュ報告を毎回ゼロから読ませない — 既知バグ早見表を先に grep し…●ARGON — gemini-4-argon が 10/13 に GA。複雑なコーディング・エージェント・数学・科学向けです●DEEP RES — deep-research-pro-preview-12-2025 は 10/23 に停止、残り6日。移行先は deep-research-preview-04-2026●NANO — gemini-nano-banana-2.1 が GA(10/06)。gemini-3.1-flash-image は非推奨で停止日は未発表です●MCP — ツール結果が 8.5万トークンに膨らんだ事例を、ADK で 310 トークンに包んで抑えた報告が出ています●FLASH — gemini-3.7-flash と 3.5-flash は新しい Flash モデルに自動で回されます(10/08)●NEW — クラッシュ報告を毎回ゼロから読ませない — 既知バグ早見表を先に grep し…
記事一覧/開発ツール
⟐ 開発ツール/2026-04-03上級

Next.js 15 App Router × Gemini API フルスタック本番構築

Next.js 15 App RouterとGemini APIを組み合わせたフルスタックAIアプリを本番レベルで構築する完全ガイド。Server Actions、Streaming、RAG、認証・レート制限まで徹底解説します。

nextjs3gemini-api287app-routerserver-actionsstreaming18rag21typescript16production105

✦ プレミアム記事

取り組みの背景:Next.js × Gemini API が最強の組み合わせである理由

Next.js 15 は 2025 年末に安定版がリリースされ、App Router によるサーバーコンポーネント・Server Actions・Partial Prerendering(PPR)が実用段階に達しました。これと Gemini 2.5 Pro の組み合わせは、AI 機能を持つウェブアプリ開発において現在最も生産性の高い選択肢の一つです。

ここで扱うのは単なる "hello world" を超えた 本番運用に耐えうるフルスタック AI アプリ を構築するために必要な知識を体系的に解説します。対象読者は Next.js の基礎を理解しており、Gemini API を本格的なプロダクトに組み込みたい中〜上級者です。

この記事で扱うトピックは以下の通りです。

  • Next.js 15 App Router のアーキテクチャと Gemini API の統合方針
  • Server Components・Server Actions からの Gemini 呼び出しパターン
  • Streaming レスポンスの完全実装(Edge Runtime 対応)
  • RAG(Retrieval-Augmented Generation)パイプラインの構築
  • 認証・レート制限・エラーハンドリングの本番実装
  • Vercel / Cloudflare Workers へのデプロイと環境変数管理
  • コスト最適化とキャッシング戦略

環境準備とプロジェクトセットアップ

Next.js 15 プロジェクトの初期化

npx create-next-app@latest my-gemini-app \
  --typescript \
  --tailwind \
  --app \
  --src-dir \
  --import-alias "@/*"
 
cd my-gemini-app
 
# Gemini API SDK をインストール
npm install @google/generative-ai
# Vercel AI SDK(Streaming 対応)
npm install ai @ai-sdk/google
# 認証(オプション)
npm install next-auth@beta

環境変数の設定

.env.local を作成し、APIキーを設定します。

# .env.local
GEMINI_API_KEY=YOUR_GEMINI_API_KEY
# Vercel AI SDK 用(@ai-sdk/google で自動的に参照される)
GOOGLE_GENERATIVE_AI_API_KEY=YOUR_GEMINI_API_KEY

重要: GEMINI_API_KEY という変数名には NEXT_PUBLIC_ プレフィックスを絶対に付けないでください。クライアントサイドにAPIキーが露出します。すべての Gemini API 呼び出しはサーバーサイド(Server Component / Server Actions / Route Handler)から行います。

Gemini API クライアントの初期化(シングルトンパターン)

// src/lib/gemini.ts
import { GoogleGenerativeAI } from "@google/generative-ai";
 
// Next.js の開発環境でのホットリロード対策(シングルトン)
const globalForGemini = globalThis as unknown as {
  geminiClient: GoogleGenerativeAI | undefined;
};
 
export const geminiClient =
  globalForGemini.geminiClient ??
  new GoogleGenerativeAI(process.env.GEMINI_API_KEY!);
 
if (process.env.NODE_ENV !== "production") {
  globalForGemini.geminiClient = geminiClient;
}
 
// よく使うモデルを取得するヘルパー
export function getModel(modelName = "gemini-2.5-pro") {
  return geminiClient.getGenerativeModel({ model: modelName });
}

✦

ここまでお読みいただきありがとうございます。

この記事の続きを読む

この先には、実装コードやベンチマーク結果など、実務でお役に立てる内容をご用意しています。このサイトは広告を掲載しておらず、サーバーや開発にかかる費用はメンバーの皆様のご支援で成り立っています。もしお役に立てていましたら、ご支援いただけますと大変ありがたいです。

この記事で得られること
✦Next.js 15 App Router の Server Components・Server Actions × Gemini API を使った本番品質のアーキテクチャを習得できる
✦Streaming レスポンス・RAG パイプライン・レート制限の実装パターンを完全なコード付きで理解できる
✦Vercel / Cloudflare Workers へのデプロイ戦略と API キー管理・コスト最適化の実践手法を学べる
Stripe による安全な決済 · いつでもキャンセル可能
✦

この記事を購入する

この先の内容をすべてお読みいただけます。一度のご購入で、いつでも何度でもアクセスできます。このサイトは広告を掲載しておらず、皆さまのご支援がサーバー費用などの運営を支えています。

または
メンバーシップなら全記事が読み放題 →
シェア

お読みいただきありがとうございます

Gemini Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • ✦コピー&ペーストで使える実装コード付き
  • ✦毎日新しい上級ガイドを追加
  • ✦¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

関連記事

⟐ 開発ツール2026-03-31
Gemini API × React Native 本番運用ノート — 個人開発アプリで踏んだ落とし穴と設計判断
iOS/Android 両対応の個人開発アプリで Gemini API を React Native/Expo から呼ぶ時に踏んだ落とし穴、AdMob 連携時のモデル振り分け、Cold Start とコスト、AsyncStorage キャッシュの TTL 設計をまとめた運用ノート
◈ API / SDK2026-04-21
Gemini の思考サマリーを UI に見せる実装設計 — Next.js で「根拠が見える」AI アプリを作る
Gemini 2.5 / 3 の思考サマリー(thought summaries)を Next.js の UI に取り込み、AI の判断根拠をユーザーに伝える実装を解説します。SDK 設定・SSE・React の折り畳み表示・UX 設計・観測までを通しで扱う本番向けガイドです。
⟐ 開発ツール2026-04-18
Gemini API × Tauri 2.0 でクロスプラットフォームAIデスクトップアプリを構築する
Tauri 2.0とGemini APIを組み合わせてmacOS・Windows・Linux対応のデスクトップAIアプリを構築する実践ガイド。Rustバックエンドによる安全なAPIキー管理、ストリーミング配信、ネイティブOS機能との連携を動くコードで解説します。