トラブルシューティング
BibGenie でよくあるエラーを診断し、モデル、ネットワーク、設定の問題を解決します。
このページでは、BibGenie でよくあるエラーを診断し、適切な次の手順を選ぶための情報をまとめています。
まず更新してください
トラブルシューティングの前に、BibGenie の最新版を使用していることを確認してください。モデル、Zotero 互換性、ネットワークに関する多くの問題は、新しいリリースですでに修正されている場合があります。
エラー詳細は重要です
BibGenie でよくあるエラーを診断し、モデル、ネットワーク、設定の問題を解決します。
このページでは、BibGenie でよくあるエラーを診断し、適切な次の手順を選ぶための情報をまとめています。
まず更新してください
トラブルシューティングの前に、BibGenie の最新版を使用していることを確認してください。モデル、Zotero 互換性、ネットワークに関する多くの問題は、新しいリリースですでに修正されている場合があります。
エラー詳細は重要です
エラーダイアログには、モデル名、Request URL、プロバイダーの応答、失敗理由などの有用な情報が含まれることがあります。設定を変更する前に、内容をよく確認してください。
"ModelNotSupported" というタイトルのダイアログ。
選択中のモデルが現在の入力タイプに対応していません。Vision 入力に対応していないモデルへ画像を送信した場合によく発生します。
画像やスクリーンショット入力には Vision など、必要な機能に対応したモデルを選びます。
カスタムモデルを使っていて、そのモデルが画像に対応している場合は、Custom Models で Vision モデルとしてマークされているか確認します。
タスクでツール利用が必要な場合は、モデルが Function Calling に対応していることを確認します。
"AI_APICallError" というタイトルのダイアログ。
モデル API リクエストに失敗しました。一般的な原因には、無効な API Key、誤った Model ID、不正な Base URL、プロバイダーのタイムアウト、ネットワーク障害などがあります。
無効または期限切れのキーでは、次のようなメッセージが表示されることがあります。
Unauthorized Failure reason: Authentication Fails
(auth header format should be Bearer sk-...)Incorrect API key provided.API Key が完全で有効であり、選択したプロバイダーのものか確認してください。
誤った Model ID では、次のようなメッセージが表示されることがあります。
Model Not ExistBibGenie の Model ID と、プロバイダーが表示している正確なモデル ID を照合してください。
不正な Base URL は、リクエストエラーや 404 エラーを引き起こすことがあります。
バージョンパスを確認
TypeError: NetworkError when attempting to fetch resource. のようなエラー。
BibGenie がプロバイダーのエンドポイントへ到達できませんでした。
考えられる原因:
BibGenie が PDF、スナップショット、ノート、選択テキストを読めない場合:
外部 MCP クライアントが接続できない場合:
問題が続く場合は、問い合わせ時に次の情報を送ってください。
サポートチャンネル
サポートが必要な場合は、BibGenie Discord コミュニティ に参加できます。
多くのプロバイダーでは、Base URL が /v1 で終わる必要があります。/v1/ ではなく /v/ のような URL は失敗します。