BibGenie 文档错误排查
BibGenie 常见错误的诊断与解决方案
在使用 BibGenie 过程中，您可能会遇到一些错误提示。本页面将帮助您快速定位问题原因并找到解决方案。
错误信息很重要
错误对话框中通常会包含详细的错误信息，请仔细阅读这些信息，它们能帮助您更快地定位问题。
ModelNotSupported
错误描述
对话框出现以 "ModelNotSupported" 为标题的错误提示。
问题原因
选择的模型不支持当前输入类型。通常发生在用户输入图片，但所选模型不支持图片输入时。
解决方案
检查自定义模型配置
如果您确信所选模型支持图片输入但仍出现此错误，请检查自定义模型配置是否正确将模型标记为 Vision 模型。
AI_APICallError
错误描述
对话框出现以 "AI_APICallError" 为标题的错误提示。
问题原因
模型 API 调用失败。可能的原因包括：配置错误、密钥无效、端点错误、调用超时等。
常见错误信息
密钥格式不正确或已过期时，会出现类似以下错误信息：
Unauthorized Failure reason: Authentication Fails
(auth header format should be Bearer sk-...)
Model: deepseek-reasoner
Request URL: https://api.deepseek.com/v1/chat/completionsIncorrect API key provided: ''.
You can find your API key at https://platform.openai.com/account/api-keys.Failure reason: [{"error":{"code":400,"message":"Missing Authorization header.","status":"INVALID_ARGUMENT"}}]模型 ID 不正确或不存在时，会出现类似以下错误信息：
Model Not Exist Failure reason:
{"error":{"message":"Model Not Exist","type":"invalid_request_error","param":null,"code":"invalid_request_error"}}Base URL 配置不正确时，会出现类似以下错误信息：
Base URL Not Found Failure reason:
{"error":{"message":"Base URL Not Found","type":"invalid_request_error","param":null,"code":"invalid_request_error"}}Model: deepseek-chat
Request URL: https://api.deepseek.com/v/chat/completions注意 URL 格式
请注意上方示例中 URL 路径错误：/v/ 应为 /v1/。
解决方案
NetworkError
错误描述
对话框出现以 "Error" 为标题的错误，内容为 TypeError: NetworkError when attempting to fetch resource.
问题原因
连接模型 API 时网络请求失败。
可能的原因
使用 Ollama、LM Studio 等本地模型时：
- 模型 API 地址配置不正确
- 本地模型服务未启动
- 端口被占用或防火墙阻止
排查步骤：
使用内置模型（如 OpenAI、Claude 等）时：
- 网络环境无法访问对应的 API 服务
- 代理配置不正确
排查步骤：
- 检查网络代理设置是否正确
- 尝试在浏览器中直接访问 API 端点
- 如在中国大陆，部分服务可能需要配置代理
需要更多帮助？
如果以上方案无法解决您的问题，欢迎加入我们的 Discord 社区 获取支持。