すべての記事
Webhooks に移しても、デプロイの瞬間にイベントは落ちる — Gemini 長時間オペレーションを照合で二重化した運用メモ
ポーリングから Webhooks へ移した後でも、デプロイや一時的な 5xx の瞬間にイベントは取りこぼされます。Gemini の長時間オペレーションを操作台帳と低頻度の照合ポーラーで二重化し、終端イベントの欠落を拾い直す設計を実装メモとして残します。
WindowsでGemma 4をローカル実行する — Ollamaでコマンド2つから始める手元のLLM
Googleの軽量オープンモデル Gemma 4 を、Windows のノートPCでローカル実行する手順をまとめます。Ollama を使えば実質コマンド2つでインストールから起動まで完結します。クラウドのGemini APIと手元のGemmaをどう使い分けるかの観点まで。
Gemini API を Edge に載せると subrequest 上限で静かに落ちる — 残量を計装して守る運用メモ
Gemini API を Cloudflare Workers で運用していると、平常時は問題ないのに負荷やツール連鎖が深まった瞬間だけ subrequest 上限で落ちます。残量をリクエスト単位で計測し、予算として守るための計装パターンと実装を、個人開発で運用しているサイト群の知見からまとめます。
Gemini APIのFunction Callingが無限ループする原因と止め方
Function Callingを組んでいたら、同じツールを何度も呼び続けて処理が終わらなくなる。そんなときに原因を特定し、最短で止めるための診断と対策をまとめました。デフォルトモデルの世代交代で再発するループの検知や、結果ベースのストール検出まで実装で示します。
File Search のストアが本番で静かに陳腐化する — カタログ同期とドリフト検知を実装した運用メモ
File Search に一度カタログを流し込んで終わりにすると、配信を止めたアセットを案内する『古い回答』が本番で返り始めます。ハッシュ差分の増分取り込みと、削除を割り切るブルーグリーン再構築、そして定期ドリフト検知までを実装で整理しました。
Gemini 3.2 Pro の Function Calling を iOS/Android アプリに統合する実装パターン
Gemini 3.2 Pro の Function Calling を iOS/Android アプリに統合する実装ガイド。SwiftUI・Kotlin 両対応の動くコード例と、個人開発の壁紙アプリで実証した本番設計パターン（コスト・レイテンシ・段階ロールアウト・回帰テスト）を解説します。
Gemini API の平均レイテンシは速いのに、たまに固まる — p95/p99 を守る運用メモ
平均TTFTは速いのに、一定割合のユーザーだけ応答が固まる — これはテールレイテンシ（p95/p99）の問題です。計測の取り方からモデルルーティング・ストリーミング予算・キャッシュ会計・リトライ設計まで、本番で効いた防衛策をコード付きで共有します。
Gemini API の Function Calling 実装 — 並列実行・ツールチェーン・Managed Agents の使い分け
Gemini API の Function Calling を本番で運用する実装パターンを、並列実行・エラー処理・ツールチェーンから Managed Agents との使い分け、GA モデルのピン留めまで動くコードで解説します。
Nano Banana 2 に動画を渡してサムネイルを1枚生成する — gemini-3.1-flash-image の動画→画像を実装したメモ
GA になった gemini-3.1-flash-image（Nano Banana 2）に動画ファイルを文脈として渡し、サムネイルを1枚生成する実装手順です。フレーム抽出との違い、preview からの移行差分、1枚あたりのコストと所要時間の実測までまとめました。
Gemini API のアプリで、無料ユーザーのコストが粗利を食う前に — ティア設計とコスト上限の実装メモ
Gemini API を組み込んだアプリの粗利を守るには、回数制限ではなく『1ユーザーあたりの月次コスト天井』で設計します。ティア別モデルルーティング、KVでの実コスト計測、トークン膨張の潰し方を実装例で示します。
Gemini の画像生成をワークフローに組み込む — プロンプト設計から動画→サムネイル自動生成まで
Gemini の画像生成を「運」ではなく再現可能なワークフローとして回すための実践メモです。プロンプト設計の要点から、Nano Banana 2 のGAで可能になった動画→1枚絵の自動生成、出荷前の品質ゲート、preview停止に備える設計までを動くコード付きでまとめます。
Gemini API × Google Cloud 本番エラーを層で切り分ける診断手順
Gemini APIをGoogle Cloud本番環境で運用する際のエラーを体系的に診断。IAM権限・Vertex AI vs AI Studio・VPC・クォータ管理・サービスアカウント設定まで、実装コード付きで完全解説します。