すべての記事
Apple Vision Framework × Gemini API のハイブリッド画像認識 ─ 壁紙アプリでクラウド推論コストを 7 割削減した設計メモ
iOS の Apple Vision Framework でオンデバイス事前フィルタを行い、Gemini Vision API への送信を半分以下に絞った壁紙アプリの実装記録。コスト・精度・レイテンシの実測値と、ハマりどころを共有します。
Gemini File API に半年分の AppStore レビュー CSV を投げて分類した2週間の運用ログ
App Store Connect から書き出した半年分のレビュー CSV を、Gemini File API に直接投げて分類・要約させる仕組みを2週間動かしました。Batch Mode との使い分け、トークン消費の落とし所、つまずいたところを淡々と記録します。
Gemini API のリクエスト Hedging で p99 レイテンシのテールを抑える設計
Gemini API のテールレイテンシ問題を、二重リクエスト方式の Hedging で攻略する設計記録です。個人開発の本番アプリ運用で得た p50/p95/p99 の実数値と、課金増を 18% に抑えた節度ある実装パターンを公開します。
Gemini File API でアップロードしたファイルが48時間後に消える問題への対処法
Gemini File API のファイルは48時間で削除される仕様です。突然 PERMISSION_DENIED や NOT_FOUND が返るようになった原因と、再アップロードを前提とした実装パターンを整理します。
Gemini API × Sentry でLLMエラー追跡とプロンプト失敗を観測する本番運用パイプライン
Sentry のエラートラッキングと Gemini API 固有の失敗パターンを組み合わせ、プロンプト崩壊・安全フィルタ発火・トークン超過まで本番で観測する実装パイプラインを設計します。
Gemini API のストリーミングが本番で「途中で切れる」とき、私が試している原因切り分けの順序
Gemini API のストリーミング応答が本番で途中で切れる症状を、ネットワーク・SDK・サーバー側のどこから疑うかの順序を、個人開発で実際に踏んだ事例ごとに整理しました。
Gemini 2.0 Flash の廃止スケジュールに個人開発を振り回されないための運用設計 — 5 月時点のリスク分散ノート
Gemini 2.0 Flash の廃止が 6 月に控える現状で、個人開発の本番ジョブを「廃止スケジュールに振り回されない」ように設計し直した私の運用ノート。プロバイダ抽象、コスト試算、移行リハーサルまで実体験ベースで残します。
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 API で MALFORMED_FUNCTION_CALL が返ってくるときの原因と対処
Gemini API の function calling で finishReason: MALFORMED_FUNCTION_CALL が返ってくる現象について、再現条件・3つの根本原因・実運用で効いた対処を整理しました。