すべての記事
Gemini File APIのファイルが「PROCESSING」のまま止まる:タイムアウト処理とリトライ設計
Gemini File APIでアップロードしたファイルがPROCESSING状態のまま進まない問題を解説。ポーリングの正しい実装・タイムアウト設計・失敗時のクリーンアップまで、実際のコードで解決します。
個人開発12年目が実測した Gemini API・Claude API・GPT-4o の費用対効果比較
壁紙アプリのバックエンドで Gemini 2.5 Flash・Claude Sonnet・GPT-4o を実運用し、コスト・速度・出力品質を実測した比較記録です。月間リクエスト数別のコスト試算と、個人開発12年の視点から見た3モデルの使い分けの結論まで踏み込みます。
Gemini 3.2 API に切り替えたら動かなくなった — 私が実際にぶつかったエラーパターンと対処法
Gemini 3.2 API への移行後に頻発するエラー5種を実例コード付きで解説。モデルID誤り・レート制限・コンテキスト超過・ストリーミング断裂・Function Calling スキーマ違反の診断と修正方法を紹介します。
Gemini 3 Pro × Firebase Cloud Messaging で個人アプリのプッシュ通知をパーソナライズ配信する本番運用ガイド
個人開発のアプリでプッシュ通知の開封率が頭打ちになっている方へ。Gemini 3 Pro でユーザーの最終操作・課金状態・好みに応じた文面を生成し、Firebase Cloud Messaging で配信する本番設計を、実装コード・コスト試算・落とし穴まで含めて整理しました。
Gemini Embedding をブラウザに持たせる — IndexedDB でサーバーレスな FAQ 検索を作った話
数千件規模のFAQやヘルプ記事を、サーバーを立てずにブラウザ側で意味検索する設計を実装した記録です。Gemini Embedding を build 時に一度だけ叩き、IndexedDB にキャッシュして cosine 類似度で引きます。
Gemini Embedding の output_dimensionality を 768 から 256 に切り詰めたら、ベクトル DB のストレージが 3 分の 1 になりました
個人開発の壁紙アプリで gemini-embedding-001 の出力次元を 768 から 256 へ削った経験をもとに、Matryoshka 表現の切り詰めとストレージ・コスト・精度のトレードオフを、移行手順・int8 量子化のコード・本番ロールアウトのチェックリストまで実数で記録します。
Gemini API で User location is not supported が出たときに、本番環境で試した解決の順番
Cloudflare Workers や Vercel から Gemini API を呼んだときに突然出る『User location is not supported』エラー。個人開発のサーバー移行中に遭遇した実例をもとに、原因切り分けから本番復旧までの順番をまとめました。
Gemini API で大きなPDFや動画を inlineData で送ると RESOURCE_EXHAUSTED — Files API への切り替え判断
Gemini API で大きなPDFや動画ファイルを inlineData で送って RESOURCE_EXHAUSTED が出る原因と、Files API への現実的な移行手順を、個人開発の現場感覚でまとめます。
Gemini APIで tools と responseSchema を同時指定すると400になる — Function Callingと構造化出力を両立する3つの設計
Function Callingで外部APIを呼びつつ、最終回答は決まった形のJSONで受け取りたい。tools と responseSchema を両方指定すると400エラーになる仕様の理由と、本番で安定して動く3つの回避設計を実装例つきで解説します。
Gemini API に画像を送る前に Pillow で縮小しておくべき理由
Gemini API のマルチモーダル入力で iPhone の写真をそのまま投げているとレイテンシも料金も静かに膨らみます。Pillow で前処理するだけで結果が変わった実例と、私が普段使っている縮小関数をまとめました。
Gemini Live API で画面共有しながら音声で対話する『AI ペアプログラマー』を TypeScript で構築する
Gemini Live API と getDisplayMedia で『画面を見せながら音声で相談できる AI ペア』を TypeScript で構築する手順を、コスト最適化と落とし穴まで含めて実装プレイブックにまとめました。
Gemini 2.5 Pro から Gemini 3.2 Pro へ 7 日で完全移行する実装プレイブック — プロンプト互換性検査・出力差分の自動評価・ロールバック設計
Gemini 2.5 Pro で稼働中の本番システムを 3.2 Pro へ 7 日で移行する実装プレイブック。プロンプト互換性検査・LLM-as-Judge による出力差分採点・5 秒で戻せるロールバック設計まで動くコード付きで解説します。