Gemini API のセーフティフィルタが正当な応答を黙って落とすとき — 全切りせず誤検知だけを救う運用メモ
本番のGemini APIで正当なプロンプトがSAFETYでブロックされる誤検知を、全カテゴリ無効化に逃げずに扱う運用メモ。入力ブロックと出力ブロックの切り分け、誤検知率の計装、カテゴリ別の段階的リカバリまでを実装で整理します。
Gemini API の空応答を finish_reason から逆引きする — 診断フロー・再試行分類・監視の実務
response.text が空になる問題は candidates・prompt_feedback・finish_reason の3層で診断できます。思考トークンによる出力枯渇の検出、再試行可否の分類器、空応答率の監視まで、本番で運用している実装をまとめました。
Gemini File APIのファイルが「PROCESSING」のまま止まる：タイムアウト処理とリトライ設計
Gemini File APIでアップロードしたファイルがPROCESSING状態のまま進まない問題を解説。ポーリングの正しい実装・タイムアウト設計・失敗時のクリーンアップまで、実際のコードで解決します。
Gemini APIで突然の「RECITATION」エラー — 著作権ブロックの正体と回避法
HTTP 200 なのに応答が途中で切れ、finish_reason に RECITATION が入っている——Gemini API の著作権ブロックが発火する条件と回避策を解説します。変換タスクへのプロンプト書き換え、temperature 調整、自動リトライの実装パターンを扱います。
Gemini API を個人アプリに組み込む時の 7 つの設計判断 — エラー設計から品質モニタリングまで
Gemini API を個人アプリに本番導入した時に直面する設計判断を、私自身の運用記録から 7 つに絞ってまとめました。コストとレイテンシのトレードオフ、エラー時のフォールバック設計、品質モニタリングまで、教科書には載っていない実戦的な判断軸を共有します。
Gemini API のストリーミングレスポンスを完全制御する — チャンク処理・エラーリカバリ・UX最適化
回答が途中で止まる、文字化けする、同じ文章が二重に出る——Gemini API のストリーミングを本番品質にするための実装ガイドです。チャンクの内部構造、バッファリングによる文字化け防止、接続断からの自動復帰、フロントエンドのレンダリング戦略を扱います。
Gemini API 実践トラブルシューティング — 2.5 Pro のレート制限・タイムアウト・レスポンスエラーを実践
Gemini 2.5 Pro API で発生する 429（レート制限）、504（タイムアウト）、400（バリデーション）エラーを体系的に解説。実装済みの修正コード、指数バックオフ戦略、Safety Filter 対策、コスト最適化まで、本番環境で使える実践的なガイド。
Gemini API 本番運用ノート — 429・500・503 に静かに耐えるエラーハンドリングとレート制限の設計
Gemini API を本番で動かして気づいた、エラーハンドリングとレート制限の運用パターンの記録です。指数バックオフ・ジッター・サーキットブレーカー・トークンバケット・モデルカスケードを、個人開発アプリで踏んだ落とし穴と実測メトリクス付きで整理しました。