Gemini API × Google Cloud 本番エラーを層で切り分ける診断手順
Gemini APIをGoogle Cloud本番環境で運用する際のエラーを体系的に診断。IAM権限・Vertex AI vs AI Studio・VPC・クォータ管理・サービスアカウント設定まで、実装コード付きで完全解説します。
Gemini API モデル非推奨・移行エラーの対処法
Gemini API でモデルが非推奨になった時の移行手順と、移行時に発生するエラーの対処法を詳しく解説します。
Gemini API implicit caching が効かない・課金がおかしい — 原因別トラブルシューティング
Gemini API の implicit caching が効かない、キャッシュヒット率が低い、コスト削減を期待したのに請求が変わらないといった問題を、原因別に整理して解決策をコード付きで紹介します。
Gemini Live API の応答音声が速回しに聞こえる — サンプルレート取り違えの直し方
Gemini Live API の応答音声が甲高く速回しに聞こえる、あるいはノイズ混じりになる症状は、ほとんどが 24kHz の出力を別のサンプルレートで再生していることが原因です。ブラウザと iOS の両方で、取り違えを直す具体的なコードを記録します。
NotebookLM の音声概要が日本語ソースなのに英語で生成される/途中で止まるときの対処
NotebookLM の Audio Overview が日本語ソースから英語音声で生成される・進捗バーが固まる・途中で停止する問題について、出力言語設定の場所や混在ソースの整理方法など、5つの原因と対処手順を実体験ベースで整理しました。
iOS の URLSession で Gemini API のストリーミングがバックグラウンド復帰時に途切れる原因と対処
iOS アプリで Gemini API のストリーミング応答を受け取っている最中にアプリを一旦バックグラウンドに送って戻ると、接続が切れて続きが返ってこない――そんな現象に遭遇したときの原因切り分けと、URLSession 周りの最小修正をまとめます。
Gemini File API でアップロードしたファイルが48時間後に消える問題への対処法
Gemini File API のファイルは48時間で削除される仕様です。突然 PERMISSION_DENIED や NOT_FOUND が返るようになった原因と、再アップロードを前提とした実装パターンを整理します。
responseSchema の enum 指定なのに違う文字列が返る — Gemini API で起きる原因と回避策
Gemini API の responseSchema で enum を指定したのに、許可値以外が返ってくる現象の原因と、私が壁紙アプリの自動分類で実際に使っている回避策を紹介します。
Gemini API の seed を指定しても出力が毎回変わる原因と対処
Gemini API の generationConfig に seed を指定したのに、同じプロンプトで毎回異なる結果が返ってくる現象の原因と、現実的な対処方針を整理しました。
Apps Script から Gemini API を呼ぶと長い生成で止まる原因と対処 — UrlFetchApp タイムアウトと 6 分実行上限の壁
Apps Script から Gemini API を呼んだときに UrlFetchApp のタイムアウトと 6 分の実行上限のどちらで止まっているかを見分け、分割実行・チェックポイント・トリガー再開で乗り切る実用パターンをまとめます。
Next.js App Router の Server Actions から Gemini API を呼ぶときのエラー診断と解決策
Next.js App Router の Server Actions で Gemini API を呼ぶときに出る環境変数の undefined、ストリーミング不可、デプロイ後のみ出る Internal Server Error など実際のエラーと解決策をまとめました。
Gemini API Embedding で踏んだ3つの地雷 — 壁紙アプリのカテゴリ自動分類で遭遇したエラーと対処法
Gemini API Embedding を壁紙アプリのカテゴリ自動分類に組み込んだ際に踏んだ3つのエラー（INVALID_ARGUMENT・RESOURCE_EXHAUSTED 429・RAG精度低下）と実際の修正コードを紹介します。