BibGenie 文档自定义模型
添加和管理自定义模型，包括 OpenAI、Anthropic、OpenRouter、Ollama、LM Studio 和兼容 API。
自定义模型让你可以使用自己的 API Key、第三方 provider、本地模型或机构内部模型服务。配置完成后，BibGenie 会从本地 Zotero 插件直接向你填写的 provider 发起请求。
添加模型
打开 BibGenie，进入 Model Settings。
在 Custom Models 区域点击 Add Model。
先选择或输入 Provider ID。BibGenie 会从模型目录中加载常见 provider，并在你选择后自动补全 Provider Name、Provider Type 和 Base URL。
再选择或输入 Model ID。如果该模型存在于目录中，BibGenie 会自动补全 Model Name、Family、Model Types、Context Window、Max Tokens、Description 等字段。
填写 API Key。如果是 Ollama 等本地服务，通常不需要 API Key。
点击 Test 测试连接。连接成功后会显示 Connected；失败时会显示错误信息。
检查自动补全的字段是否正确，必要时手动调整 Model Types、Context Window 或 Max Tokens。
点击 Add Model 保存。保存后模型会自动启用，并出现在聊天页面的模型选择器中。
自动补全
Add Custom Model 并不是完全手动填写。BibGenie 会尝试从 models.dev 的模型目录加载 provider 和 model 信息：
- Provider ID 输入框支持搜索常见 provider，也支持手动输入 custom provider。
- 选择 provider 后，会自动填入 Provider Name、Provider Type 和 Base URL。
- Model ID 输入框会根据当前 provider 显示可选模型，也支持手动输入 custom model。
- 选择目录中的模型后，会自动填入 Model Name、Family、Model Types、Context Window、Max Tokens、Description，以及模型价格信息。
- 如果模型目录加载失败，BibGenie 会使用内置 fallback provider 列表，仍然可以手动添加模型。
优先使用自动补全
如果你的 provider 和 model 能在下拉搜索中找到，建议优先选择目录项，而不是手动输入。这样可以减少 Provider Type、Base URL、模型能力和上下文长度配置错误。
配置字段
| 字段 | 是否必填 | 说明 |
| :--- | :--- |
| Provider ID | 必填 | provider 的唯一标识，例如 openai、anthropic、openrouter，也可以手动输入自定义 provider ID |
| Provider Name | 必填 | provider 的展示名称，选择目录中的 provider 后会自动补全 |
| Model ID | 必填 | provider API 实际调用的模型 ID，例如 gpt-4.1、claude-sonnet-4-5 |
| Model Name | 必填 | 在 BibGenie UI 中显示的模型名称，选择目录中的模型后会自动补全 |
| API Key | 可选 | 你的 provider 密钥；Ollama 等本地模型通常不需要 |
| Base URL | 可选 | API 请求地址；选择目录中的 provider 后通常会自动补全，兼容服务或本地服务可能需要手动确认 |
| Provider Type | 必填 | 模型服务类型，例如 OpenAI、Anthropic、Ollama、OpenAI Compatible |
| Family | 可选 | 模型家族，例如 qwen、gpt、claude，目录模型通常会自动补全 |
| Model Types | 必填 | 模型能力，如 Text、Vision、Reasoning、Function Calling、Web Search |
| Context Window | 可选 | 模型上下文窗口，目录模型通常会自动补全 |
| Max Tokens | 可选 | 单次输出上限，目录模型通常会自动补全 |
| Description | 可选 | 模型说明，目录模型通常会自动补全 |
Provider Type 怎么选？
| Provider Type | 适用情况 |
|---|---|
| OpenAI | 使用 OpenAI 官方 API |
| Anthropic | 使用 Anthropic Claude API |
| xAI | 使用 xAI Grok API |
| DeepSeek | 使用 DeepSeek 官方 API |
| 使用 Gemini API | |
| Groq | 使用 Groq API |
| Moonshot AI | 使用 Kimi / Moonshot API |
| OpenRouter | 使用 OpenRouter API |
| Alibaba | 通常按 OpenAI Compatible 接入 |
| Z.AI / Zhipu AI | 通常按 OpenAI Compatible 接入 |
| Ollama | 使用本地 Ollama 服务 |
| OpenAI Compatible | 使用 LM Studio、中转服务、机构内部兼容 API |
Base URL
许多官方 provider 已经内置默认 Base URL。通常只有以下情况需要手动填写：
- 使用 OpenAI Compatible provider。
- 使用中转服务。
- 使用本地模型服务。
- 你的 provider 要求使用自定义 endpoint。
示例：
https://api.openai.com/v1
https://openrouter.ai/api/v1
http://localhost:11434
http://localhost:1234/v1注意 /v1
很多兼容 API 需要 Base URL 以 /v1 结尾。如果少写版本路径，可能出现 NetworkError、404 或模型不存在。
Ollama 示例
确认 Ollama 已安装并启动。
在终端运行 ollama list，确认本地已有模型。
如果 Ollama 尚未运行，请先执行 ollama serve 启动服务。启动成功后你会看到类似 Listening on 127.0.0.1:11434 的输出。
在 BibGenie 中添加模型，Provider Type 选择 Ollama。
Base URL 使用 http://localhost:11434。
Model ID 填写 ollama list 中显示的模型名，例如 llama3.1:8b。
LM Studio 示例
LM Studio 通常通过 OpenAI Compatible 接入：
在 LM Studio 中启动本地 API Server。
在 BibGenie 中添加模型，Provider Type 选择 OpenAI Compatible。
Base URL 填写 LM Studio 显示的地址，通常类似 http://localhost:1234/v1。
Model ID 填写 LM Studio 当前加载模型的 ID。
能力标记
请根据模型真实能力勾选：
- Text：文本对话，通常必须开启。
- Vision：支持图片、截图和图表输入。
- Reasoning：适合复杂推理任务。
- Function Calling：支持工具调用，影响检索、读取和整理类任务体验。
- Web Search：只有 provider 和模型本身支持时才应开启。
如果错误标记模型能力，可能出现 ModelNotSupported 或工具调用失败。