TAG

トラブルシューティング

30 記事

Gemini APIをGoogle Cloud本番環境で運用する際のエラーを体系的に診断。IAM権限・Vertex AI vs AI Studio・VPC・クォータ管理・サービスアカウント設定まで、実装コード付きで完全解説します。

Gemini API のモデルが非推奨（deprecated）になったときの移行手順をまとめました。モデルのライフサイクルと非推奨通知の確認方法、実際の移行手順、移行時に出やすいエラーへの対処、フォールバック実装による安全な移行戦略まで解説します。

Gemini API の implicit caching が効かない、キャッシュヒット率が低い、コスト削減を期待したのに請求が変わらないといった問題を、原因別に整理して解決策をコード付きで紹介します。

Gemini Live API の応答音声が甲高く速回しに聞こえる、あるいはノイズ混じりになる症状は、ほとんどが 24kHz の出力を別のサンプルレートで再生していることが原因です。ブラウザと iOS の両方で、取り違えを直す具体的なコードを記録します。

NotebookLM の Audio Overview が日本語ソースから英語音声で生成される・進捗バーが固まる・途中で停止する問題について、出力言語設定の場所や混在ソースの整理方法など、5つの原因と対処手順を実体験ベースで整理しました。

iOS アプリで Gemini API のストリーミング応答を受け取っている最中にアプリを一旦バックグラウンドに送って戻ると、接続が切れて続きが返ってこない――そんな現象に遭遇したときの原因切り分けと、URLSession 周りの最小修正をまとめます。

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

Gemini API の responseSchema で enum を指定したのに許可値以外の文字列が返る現象を、最小再現コードから原因まで掘り下げます。プロンプトへの許可値明示、受け取り側のバリデーションとリトライ、SDK バージョン差の確認という3つの対処を示します。

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

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

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

Gemini API の Embedding をカテゴリ自動分類に組み込んで踏んだ INVALID_ARGUMENT・429・精度不足の3点を、次元の固定・切り詰め後の正規化・チェックポイント付きバッチ・recall@5 の計測台という形で整理した記録です。