Gemini API に個人情報を渡してしまう前に — PII マスキング・監査ログ・運用設計の本番実装ガイド
ユーザーから受け取ったテキストをそのまま Gemini API に渡していませんか。個人情報の検出・マスキング・監査ログまで含めた、コンプライアンス審査に通る本番運用設計を、実装コードと運用判断の両面から解説します。
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 の検証、ストリーミング応答のテストまで、個人開発で運用してきた構成をそのままお見せします。
Gemini API × Inngest で耐障害性の高いAIワークフローを構築する本番運用ガイド
Gemini APIのレート制限・タイムアウト・部分失敗に強い「耐障害性の高い」AIワークフローを、Inngestのdurable executionで実装する本番運用パターンを解説します。
Gemini API の URL Context が取得できない・空応答になる時の確認手順
Gemini API の URL Context ツールが沈黙したり空応答を返す現象は、tool 構成・URL 形式・対象サイト側の制約のいずれかで発生します。原因の切り分け方と回避策をまとめました。
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 ストリーミングや認可・レート制御まで実コードでまとめます。
Gemini API の動的 Few-Shot 設計 — ベクター検索で実例を選び続ける自己改善型プロンプト
Few-Shot プロンプトを「固定の3例」で書いているうちは精度もコストも頭打ちになります。Gemini Embeddings + ベクター検索で例を動的に選ぶ自己改善型プロンプト設計を、コピペで動くコードと運用ループまで通しで解説します。
Gemini API の usageMetadata で本番アプリのコストを記録する — リクエスト単位で請求書と突き合わせる実装パターン
Gemini API のレスポンスに含まれる usageMetadata を活用し、リクエスト単位でトークン使用量を記録する実装パターンを解説します。cachedContent や thoughts のように単価が異なるトークンを正しく集計し、月末に Google Cloud の請求書と突き合わせる方法までまとめました。
Gemini Embeddings × リランカーで本番RAGの精度を底上げする — Vertex AI Ranking と LLM-as-judge の使い分け
Embeddings だけでは取りこぼす「上位3件は当たり前に合うのに5件目以降に正解が埋もれる」問題を、Vertex AI Ranking API と Gemini を使ったリランカーで解決する本番アーキテクチャを実装コード付きで解説します。
Gemini APIで GEMINI_API_KEY と GOOGLE_API_KEY のどちらを使うか問題を解決する
Gemini API で GEMINI_API_KEY と GOOGLE_API_KEY のどちらを使うべきか迷ったときに読む実践ガイド。SDK ごとの優先順位、Vertex AI モードの自動切替、つまずきやすいハマりパターンを切り分け手順とコード例で整理します。