TAG

Troubleshooting

59 記事

Gemini API の Code Execution で詰まりやすい3パターンを実例で解決します。機能が有効になっていない最多の原因、サンドボックスで使えないライブラリの import エラー、重い処理のタイムアウトについて、エラー情報を取得する実装とあわせて紹介します。

Gemini File APIでアップロードしたファイルがPROCESSING状態のまま進まない問題を解説。ポーリングの正しい実装・タイムアウト設計・失敗時のクリーンアップまで、実際のコードで解決します。

Cloudflare Workers や Vercel から Gemini API を呼んだときに突然出る『User location is not supported』エラー。個人開発のサーバー移行中に遭遇した実例をもとに、原因切り分けから本番復旧までの順番をまとめました。

Gemini API で大きなPDFや動画ファイルを inlineData で送って RESOURCE_EXHAUSTED が出る原因と、Files API への現実的な移行手順を、個人開発の現場感覚でまとめます。

Function Callingで外部APIを呼びつつ、最終回答は決まった形のJSONで受け取りたい。tools と responseSchema を両方指定すると400エラーになる仕様の理由と、本番で安定して動く3つの回避設計を実装例つきで解説します。

Gemini 2.5 Pro を本番環境で運用して気づいた落とし穴を体系的にまとめました。レート制限の設計・Thinking モードのコスト制御・長いコンテキストの品質管理・精度低下の診断まで、実装例とともに解説します。

Gmail や Docs、Sheets で Gemini サイドパネルが表示されないときの解決手順です。アカウントの種類の確認を起点に、プランとアクセス権、言語と地域の設定、ブラウザ拡張機能やキャッシュなど、7つのチェックポイントを順にたどって復旧させます。

Gemini API が遅い、タイムアウトするという問題を、モデル過負荷・リクエスト設計・クォータ制限・ネットワークの4カテゴリで体系的に診断します。時間帯によって症状が揺れる場合の素早い診断フローと、モデル選択による最適化までまとめました。

Gemini API の100万トークンコンテキストで起きがちな問題を解決します。中間の情報が無視される Lost in the Middle、レスポンス遅延とタイムアウト、想定外のトークン料金、応答品質の不安定さ、効かないコンテキストキャッシングまで原因別に整理しました。

HTTP 200 なのに応答が途中で切れ、finish_reason に RECITATION が入っている——Gemini API の著作権ブロックが発火する条件と回避策を解説します。変換タスクへのプロンプト書き換え、temperature 調整、自動リトライの実装パターンを扱います。

Gemini で「このモデルは現在過負荷です（This model is overloaded）」と表示されたときの対処をまとめました。まず試したい3つの方法、API 利用時のエラー処理、頻発する場合の見直しポイント、503 エラーとの関係まで順に確認できます。

Gemini API に PDF を送ったのに本文が返ってこない症状を、フローチャートで切り分けて解決します。スキャン画像 PDF、20MB のインライン上限、1,000ページ制限、MIME タイプの不一致、表組みや数式の崩れという5つの原因別に対処を示します。