すべての記事
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 ストリーミング、Flash→Pro フォールバック、指数バックオフ・リトライ、レイテンシとトークンの実測まで実コードでまとめます。
Gemini API の動的 Few-Shot 設計 — ベクター検索で実例を選び続ける自己改善型プロンプト
Few-Shot プロンプトを「固定の3例」で書いているうちは精度もコストも頭打ちになります。Gemini Embeddings + ベクター検索で例を動的に選ぶ自己改善型プロンプト設計を、コピペで動くコードと運用ループまで通しで解説します。
Gemini API で翻訳精度を最大化する temperature 設定 — 用途別ベストバリューと検証コード
Gemini API の翻訳で temperature をいくつにするか、用途別の早見表と検証コードで示します。値を決めた後に効いてくる、文字列タイプ別プロファイルのコード管理、逆翻訳ゲート、UI がはみ出さない表示幅バジェットまで実装込みでまとめました。
Gemini Embeddings × リランカーで本番RAGの精度を底上げする — Vertex AI Ranking と LLM-as-judge の使い分け
Embeddings だけでは取りこぼす「上位3件は当たり前に合うのに5件目以降に正解が埋もれる」問題を、Vertex AI Ranking API と Gemini を使ったリランカーで解決する本番アーキテクチャを実装コード付きで解説します。
Gemini API が社内プロキシ・SSL検証エラーで接続できないときの対処法
個人PCでは動いた Gemini API が、会社支給のマシンや社内ネットワークから繋がらない。プロキシ環境変数・SSL検証エラー・証明書バンドルの3層を切り分けて解決する実践的なトラブルシューティングです。
Gemini APIで GEMINI_API_KEY と GOOGLE_API_KEY のどちらを使うか問題を解決する
Gemini API で GEMINI_API_KEY と GOOGLE_API_KEY のどちらを使うべきか迷ったときに読む実践ガイド。SDK ごとの優先順位、Vertex AI モードの自動切替、つまずきやすいハマりパターンを切り分け手順とコード例で整理します。
Gemini 2.5 Pro の空間理解（バウンディングボックス・セグメンテーション）を本番アプリで使いこなす
Gemini 2.5 Pro の空間理解出力を本番のモバイル/Webアプリに組み込むための実装ガイド。座標正規化・マスクのデコード・ハルシネーション検出・YOLOへの自動フォールバックまで、動作するコードと共に解説します。
Gemini API の価格優位性を活かした SaaS 設計 — 競合の半額で利益を出すコスト戦略
Gemini API のコスト構造を徹底分析し、OpenAI / Claude 対比で50%以上安い SaaS を構築しながら健全な利益率を確保する設計パターンを、損益シミュレーションと実装コード付きで解説します。
Gemini API で『人間が確認するAI』を作る — Human-in-the-Loop ワークフローを本番導入する実装ガイド
Gemini API の出力を完全自動運用するのが怖い、でも全件を人間が見るのは現実的ではありません。そんな現場のための Human-in-the-Loop（HITL）アーキテクチャを、信頼度ゲート・レビューキュー・フィードバックループの3層に分けて本番実装の粒度で解説します。
Gemini API キーをダウンタイムゼロでローテーションする実装パターン
Gemini API キーの定期ローテーションと漏えい時の即時切替を、本番サービスを止めずに行うための設計パターンを実装コード付きで解説します。デュアルキー構成、Cloudflare Workers Secrets、自動フェイルオーバー、漏えい60分対応まで網羅。