TAG

Gemini API

248 記事

Gemini API のテールレイテンシ問題を、二重リクエスト方式の Hedging で攻略する設計記録です。個人開発の本番アプリ運用で得た p50/p95/p99 の実数値と、課金増を 18% に抑えた節度ある実装パターンを公開します。

SwiftData で Gemini API レスポンスを永続化し、機内モードや低速回線でも前回の結果を再利用できる iOS アプリ向けのキャッシュ層を設計します。@Model 設計、無効化戦略、サイズ管理、移行手順までを実装ベースで整理しました。

Gemini File API のファイルは48時間で削除される仕様です。突然 PERMISSION_DENIED や NOT_FOUND が返るようになった原因と、再アップロードを前提とした実装パターンを整理します。

Gemini API の function calling で finishReason: MALFORMED_FUNCTION_CALL が返ってくる現象について、再現条件・3つの根本原因・実運用で効いた対処を整理しました。

壁紙・癒し・引き寄せ系を含む複数アプリで Gemini API を運用していると、いつの間にかキーが散らばり、コスト按分が分からなくなります。中央管理層を一枚挟む設計を、12ヶ月運用で見えた落とし穴とともに整理しました。

Golden Dataset と LLM-as-Judge を組み合わせ、Gemini API の出力品質が運用中に静かに劣化していくのを捉える評価基盤の設計を、個人開発の実運用構成とコード付きでまとめます。

Gemini Files API と Cloudflare R2 を組み合わせ、壁紙アプリの画像処理パイプラインを再設計した30日の記録です。48時間制限・冪等性・コスト監視の落とし穴と対処を、実装コードと数値で整理しました。

generationConfig に seed を指定しても Gemini API の出力が毎回変わる原因を整理しました。seed だけでは決定論にならない理由、まず確認すべき3つの設定、壁紙アプリの分類パイプラインで実践している「ほぼ決定論」を確保する運用パターンを紹介します。

個人アプリで Gemini API を本番運用していると、月に数回は確実に外部要因で詰まります。サーキットブレーカーと段階的縮退をどう設計するか、実装の骨組みと運用で詰まりやすい所を所感としてまとめます。

Apps Script から Gemini API を呼んだときに UrlFetchApp のタイムアウトと 6 分の実行上限のどちらで止まっているかを見分け、分割実行・チェックポイント・トリガー再開で乗り切る実用パターンをまとめます。

累計5,000万DLの壁紙アプリで実際に試した、Gemini APIを使ったApp Store/Google Playメタデータの多言語自動生成。翻訳精度を担保するプロンプト設計から文字数制限への対応まで、実装コードとともに公開します。

Next.js App Router の Server Actions で Gemini API を呼ぶときに出る環境変数の undefined、ストリーミング不可、デプロイ後のみ出る Internal Server Error など実際のエラーと解決策をまとめました。