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」エラー — 著作権ブロックの正体と回避法
Gemini APIが応答を途中でカットして finish_reason に RECITATION を返すエラーの原因と、再現性のある回避策を実装パターン付きで解説します。
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 を本番で動かして気づいた、エラーハンドリングとレート制限の運用パターンの記録です。指数バックオフ・ジッター・サーキットブレーカー・トークンバケット・モデルカスケードを、個人開発アプリで踏んだ落とし穴と実測メトリクス付きで整理しました。