Gemini API のセマンティックキャッシュ設計 — 埋め込みベース回答キャッシュで API コストを実用的に下げる
Gemini Embedding を使ったセマンティックキャッシュの設計と実装。完全一致キャッシュが効かない自由文プロンプトに対して、類似度しきい値・バージョン付きキー・TTL を組み合わせ、ヒット率と品質の両立を目指す実装パターンを Python と Cloudflare Vectorize のコード付きで解説します。
gemini-2.5-flash-image で参照画像が反映されない・別物が生成される時の原因と対処
gemini-2.5-flash-image（Nano Banana）で参照画像を渡したのに別物が生成される、編集指示が無視されるといった症状の切り分け手順をまとめました。parts の順序・response_modalities・画像サイズ・chat session ごとの落とし穴を、動くコードと一緒に整理しています。
Streamlit と Gemini API でブログ運営ダッシュボードを作る — GSC と GA4 を一つの画面に統合する実装メモ
個人で 6 サイトを運営するなかで毎日 GSC と GA4 を別タブで開いて疲れ果て、Streamlit に Gemini API を組み合わせて 1 画面の運営ダッシュボードを作りました。記事の品質スコアリングと、削除候補の自動抽出、KPI の週次レポート化までを実装サンプル込みで共有します。
Gemini 2.5 Flash で個人開発アプリのヘルプ翻訳を3ヶ月運用した所感
iOS / Android の個人開発アプリで提供してきた多言語ヘルプを、Gemini 2.5 Flash を中心とした翻訳パイプラインで運用し始めて3ヶ月が経ちました。Pro との使い分け、訳文ドリフトへの備え、AdMob 収益に与えた小さな効果まで、運用ログに残った所感を淡々と記録します。
Gemini API × Sentry でLLMエラー追跡とプロンプト失敗を観測する本番運用パイプライン
Sentry と Gemini API を組み合わせ、プロンプトの破綻や安全フィルタ発火、トークン超過といった LLM 特有の失敗を本番で観測するパイプラインを構築します。クライアントラッパー、成功に見える失敗を捕捉するインスペクタ、PII を守る before_send まで実装します。
Gemini API のストリーミングが本番で「途中で切れる」とき、私が試している原因切り分けの順序
Gemini API のストリーミング応答が本番で途中で切れる症状に対して、ネットワーク・SDK・サーバー側のどこから疑うべきかの順序を整理しました。まず確かめたい3つの事実、切り分けの記録テンプレート、切断を監視シグナルとして使う考え方まで共有します。
Gemini 2.0 Flash の廃止スケジュールに個人開発を振り回されないための運用設計 — 5 月時点のリスク分散ノート
Gemini 2.0 Flash の廃止に向けて個人開発の本番ジョブを設計し直した運用ノート。プロバイダ抽象・新旧モデルの差分バッチ・フォールバック率の計測・コスト試算、そして廃止日を過ぎた 8 月時点の答え合わせまでを実測値つきで残します。
Gemini API の Structured Output でバリデーションエラーが返るときの原因と対処
Gemini API の responseSchema を使った構造化出力で頻発するバリデーションエラー（INVALID_ARGUMENT、schema mismatch、空配列、不要フィールド）の原因と、実運用で安定させるための実装パターンを個人開発の現場視点でまとめます。
App Store と Google Play のレビュー差分を Gemini で出す運用を6週間続けた所感
App Store と Google Play のレビューを Gemini API で並列に分類し、プラットフォーム間の差分から優先改善項目を抽出する運用を6週間続けた記録です。累計5,000万DLの壁紙アプリで実際に見えた3つのプラットフォーム差と、月の運用コストを共有します。
Gemini API の冪等性キー設計 — 6サイト並行運用でリトライによる重複生成を防いだ実装パターン
個人で6サイトを並行運用してきた中で、Gemini API のリトライ嵐が原因の重複生成に悩まされました。SHA-256 ハッシュと Cloudflare Workers KV を組み合わせた冪等性キー設計の実装パターンと、5ヶ月分の運用知見をまとめました。
Gemini API の Recitation block が発火する条件と、応答が消えないためのプロンプト・ポストプロセス設計
Gemini API でリサーチや要約系のエージェントを長時間動かしていると、ある日突然 finishReason: 'RECITATION' が連発し始め、応答本文が空のままセッションが切れる症状に遭遇します。著作権保護のかかった長文の逐語引用と判定された時の安全機構ですが、回避するためのプロンプト設計とポストプロセスを、6サイトの自動投稿パイプラインで実装した内容ごと共有します。
Gemini 2.5 Flash と Firebase Remote Config で多言語オンボーディング文言を生成し、段階公開で検証する実装ノート
壁紙アプリ6本のオンボーディング文言を Gemini 2.5 Flash で多言語生成し、Firebase Remote Config の段階公開で D1 リテンションを検証した個人開発者の実装ノートです。Apps Script のコードと AdMob 連動の計測設計まで含めて記録しました。