Gemini API で構築する GraphRAG — 知識グラフ × ベクトル検索の本番ハイブリッド RAG
ベクトル検索だけでは答えられない関係性を辿る質問のために、Gemini で知識グラフを抽出しベクトル検索と組み合わせる GraphRAG を構築します。グラフ抽出、並列構築、質問の分岐、コンテキスト統合、本番で詰まる5つの落とし穴まで動くコードで解説します。
Zod × Gemini API: TypeScript で構造化出力を型安全に扱う実装パターン
Gemini API の構造化出力を Zod スキーマで検証する実装パターンを解説します。as による型キャストの落とし穴、JSON Schema への変換、検証失敗時のリトライ設計までコード付きで紹介します。
AI Studio で動いていたコードを Vertex AI に移したら何が変わったか — 個人開発者の移行作業ログ
AI Studio の API キーで動いていた Gemini のコードを Vertex AI に移行した作業ログです。SDK 初期化の書き換え、認証エラーで丸一日費やした環境変数、構造化出力で気づいたレスポンス形式の差異など、実際に手を動かして分かった差分を残しました。
Gemini APIの『contents must alternate between user and model』エラーが消えない理由と直し方
Gemini API で頻発する『contents must alternate between user and model』エラーの正体と、role 順序・assistant 表記・Function Calling 履歴の落とし穴を、すぐ使える修正コード付きで解説します。
Gemini API で会議音声から話者を識別する — 簡易ダイアリゼーションの実装ガイド
会議録音やポッドキャストの音声から「誰が話したか」を Gemini API のマルチモーダル音声理解で識別する方法です。話者ラベルつき JSON を返す最小構成のコード、結果を底上げする3つのプロンプトの工夫、専用ツールとの使い分けを解説します。
Gemini API に画像を渡しても「画像が見えません」と返るときの診断と対処
Gemini API に画像を入力したのに『画像は添付されていません』と返ってくる現象の原因を、mime_type・サイズ・SDK差・モデル選択の4視点で切り分け、コピペで動く修正コードまで一気通貫で解説します。
Gemini API の maxOutputTokens と stopSequences で出力を精密制御する
Gemini API の maxOutputTokens と stopSequences を組み合わせて、応答長を狙い通りにコントロールする方法を実装パターンとともに解説します。途中で切れる、長すぎる、JSON が壊れる、を一気に解決します。
Gemini API を Vitest でテストする — TypeScript プロジェクトのモック設計と Function Calling 検証パターン
TypeScript で Gemini API を呼ぶコードを Vitest でテストする実践パターンです。SDK のモック設計、Function Calling とストリーミングの検証、MSW への降ろし方、夜間に実 API を一本だけ通すスモークまで扱います。
Gemini APIで『thoughts not present in conversation history』エラーが出る - thought_signatures 欠落の対処手順
Gemini 2.5/3.x のThinkingモードでマルチターンFunction Callingを実装すると突然出る『thoughts not present in conversation history』エラーの原因と、最短5分で動く修正手順をPython SDK・ストリーミング双方の例で解説します。
NestJS で Gemini API バックエンドを設計する — DI・例外フィルタ・ガードを活かす実装パターン
NestJS の DI・例外フィルタ・ガードで保守しやすい Gemini API バックエンドを構築する実装パターンを解説します。SSE ストリーミング、Flash→Pro フォールバック、指数バックオフ・リトライ、レイテンシとトークンの実測まで実コードでまとめます。
Gemini APIで GEMINI_API_KEY と GOOGLE_API_KEY のどちらを使うか問題を解決する
Gemini API で GEMINI_API_KEY と GOOGLE_API_KEY のどちらを使うべきか迷ったときに読む実践ガイド。SDK ごとの優先順位、Vertex AI モードの自動切替、つまずきやすいハマりパターンを切り分け手順とコード例で整理します。
Google Workspace × Gemini 自動化で月5万円の副業を構築する — 3つの自動化テンプレート付き
Google Workspace と Gemini API の業務自動化を中小企業向けサービスとして販売する副業モデルの設計図です。Gmail 問い合わせ分類、売上レポート要約、議事録整形という3つの即納テンプレートと、価格設定や最初の1社を獲得する動き方まで示します。