config に「Extra inputs are not permitted」が出たら、キーの綴りを一つずつ疑います
google-genai SDK で config を渡した途端に pydantic の ValidationError（extra_forbidden）が出る原因は、ほぼ綴りの一字違いです。手元で再現した出力と、呼び出し前に怪しいキーを洗う関数、text が None になる場合の見分け方を書き残します。
Free tier と表示されているのに 429「limit: 0」— 新しい Gemini API プロジェクトで最初の 1 時間に見る順番
新しい Gemini API プロジェクトで Free tier と表示されているのに、最初の 1 回目から 429 と limit: 0 が返るときの確認順を整理しました。エラー本文の読み方と、モデル別に切り分ける 40 行ほどのスクリプトつきです。
Sheets の AI 関数が生成できないとき、上限より先に置き場所を疑う
スプレッドシートの AI 関数で「生成」が動かないとき、24 時間の上限だと決めつける前に確かめたい点をまとめました。Dropbox や Box 経由で開いた表では、そもそも生成ができません。置き場所・上限・プラン・式の順に切り分けます。
Gemini の新機能が Workspace に出てこないとき、待ちと不具合を切り分ける順序
告知された Gemini の新機能が自分の Workspace に現れないとき、それが段階展開の途中なのか設定の問題なのかを、リリーストラックと展開ペースから機械的に判定する手順と Apps Script の台帳をまとめました。
responseSchema の enum 指定なのに違う文字列が返る — Gemini API で起きる原因と回避策
Gemini API の responseSchema で enum を指定したのに許可値以外の文字列が返る現象を、最小再現コードから原因まで掘り下げます。プロンプトへの許可値明示、受け取り側のバリデーションとリトライ、SDK バージョン差の確認という3つの対処を示します。
Gemini API Embedding で詰まった3か所 — 壁紙アプリのカテゴリ自動分類で踏んだエラーと対処
Gemini API の Embedding をカテゴリ自動分類に組み込んで踏んだ INVALID_ARGUMENT・429・精度不足の3点を、次元の固定・切り詰め後の正規化・チェックポイント付きバッチ・recall@5 の計測台という形で整理した記録です。
Gemini API で DEADLINE_EXCEEDED が頻発する時に最初に見直すべき5つのポイント
Gemini API で DEADLINE_EXCEEDED が突然頻発したときの切り分けを5つのポイントに整理しました。サーバー側処理時間の計測、入力サイズのしきい値、SDK 既定タイムアウトの上書き、Pro と Flash の選び直し、指数バックオフの実装まで扱います。
Gemini API × Google Cloud 本番エラーを層で切り分ける診断手順
Gemini APIをGoogle Cloud本番環境で運用する際のエラーを体系的に診断。IAM権限・Vertex AI vs AI Studio・VPC・クォータ管理・サービスアカウント設定まで、実装コード付きで完全解説します。
Gemini API モデル非推奨・移行エラーの対処法
Gemini API のモデルが非推奨（deprecated）になったときの移行手順をまとめました。モデルのライフサイクルと非推奨通知の確認方法、実際の移行手順、移行時に出やすいエラーへの対処、フォールバック実装による安全な移行戦略まで解説します。
Gemini API implicit caching が効かない・課金がおかしい — 原因別トラブルシューティング
Gemini API の implicit caching が効かない、キャッシュヒット率が低い、コスト削減を期待したのに請求が変わらないといった問題を、原因別に整理して解決策をコード付きで紹介します。
Gemini Live API の応答音声が速回しに聞こえる — サンプルレート取り違えの直し方
Gemini Live API の応答音声が甲高く速回しに聞こえる、あるいはノイズ混じりになる症状は、ほとんどが 24kHz の出力を別のサンプルレートで再生していることが原因です。ブラウザと iOS の両方で、取り違えを直す具体的なコードを記録します。
NotebookLM の音声概要が日本語ソースなのに英語で生成される/途中で止まるときの対処
NotebookLM の Audio Overview が日本語ソースから英語音声で生成される・進捗バーが固まる・途中で停止する問題について、出力言語設定の場所や混在ソースの整理方法など、5つの原因と対処手順を実体験ベースで整理しました。