BibGenie 文件自帶 API Key
在 Zotero 中透過 BYOK 使用自己的 API Key 或本地模型，掌控 AI 文獻閱讀與 Embedding 語義檢索的資料流向，瞭解金鑰本地儲存和費用規則。
BibGenie 內建了針對文獻閱讀、理解和科研工具呼叫場景最佳化的官方模型，兼顧使用效果與價效比，開箱即用。
如果你更關注科研資料隱私，或希望使用已有的模型服務，可以透過 BYOK（Bring Your Own Key，自帶 API Key） 接入自己的服務商、機構內部模型服務或本地模型。BYOK 同時支援對話模型和 Embedding 模型，讓你控制 AI 文獻閱讀與語義檢索中的模型請求去向。
BYOK 的核心價值
控制資料流
自訂模型請求直接從本地 Zotero 外掛發往指定服務，不經過 BibGenie 伺服器。
使用本地模型
透過 Ollama 或 LM Studio，讓模型執行在你的電腦上。
不消耗 BibGenie Credit
BYOK 請求不走 BibGenie 官方模型服務，因此不消耗官方 Credit。
接入更多模型
為對話和 Embedding 分別接入所需模型或機構內部服務。
資料會經過 BibGenie 服務嗎？
當你選用自訂模型時，傳送給該模型的資料由本地 Zotero 外掛直接發往你配置的服務，不經過 BibGenie 伺服器：
| 模型用途 | 傳送給模型的資料 | 使用位置 |
|---|---|---|
| 對話模型 | 對話內容及任務所需的文獻上下文 | 聊天頁面，或設定中的預設模型 |
| Embedding 模型 | 用於索引的文獻標題、摘要，以及語義檢索的查詢文字 | 文獻庫與索引中的 Embedding Model |
對話和 Embedding 獨立配置。 使用自訂對話模型，不會自動改變 Embedding 的請求路徑；如果 Embedding 仍選用官方模型，相關請求仍由 BibGenie 官方模型服務處理。
這意味著：
- 使用 OpenAI API Key，請求會直接發往 OpenAI。
- 使用 Anthropic API Key，請求會直接發往 Anthropic。
- 使用 OpenAI Compatible 中轉服務，請求會發往你填寫的 Base URL。
- 使用本機的 Ollama 或 LM Studio 服務，相應模型請求可以留在本機。
第三方 provider 仍然會收到資料
自訂模型直連你配置的服務。如果使用雲端服務商或中轉服務，對方仍會收到相應的文獻內容、對話上下文或 Embedding 文字。請根據機構、實驗室或專案的資料政策選擇服務。
API Key 儲存在哪裡？
你填寫的 API Key 和模型連線配置僅儲存在本地 Zotero 中，不會上傳至 BibGenie 伺服器。API Key 由外掛直接用於向你配置的模型服務發起請求，無需將金鑰託管給 BibGenie。
使用本地模型
透過 Ollama 或 LM Studio，可以讓模型計算在本機完成。若希望對話和語義檢索的模型請求都在本地處理，需要分別新增並選用本地對話模型和本地 Embedding 模型。本地服務需保持執行，並準備好對應用途的模型。
語義索引儲存在本地，並不代表生成向量的計算也在本地；這取決於你選用的 Embedding 模型。
支援哪些模型服務？
對話模型支援以下 Provider Type：
| Provider | 說明 |
|---|---|
| OpenAI | OpenAI GPT 系列模型 |
| Anthropic | Claude 系列模型 |
| xAI | Grok 系列模型 |
| DeepSeek | DeepSeek 模型 |
| Gemini 模型 | |
| Groq | Groq 託管的高速模型 |
| Moonshot AI | Kimi 系列模型 |
| OpenRouter | 統一模型路由平臺 |
| Ollama | 本地模型服務 |
| OpenAI Compatible | 任何相容 OpenAI API 格式的服務 |
LM Studio 通常可以透過 OpenAI Compatible 接入。
Embedding 模型當前支援 OpenAI、Google、OpenAI Compatible、OpenRouter 和 Ollama，具體模型也必須提供 Embedding 能力。
如何收費？
自訂對話和 Embedding 請求不消耗 BibGenie Credit。雲端服務的費用由你與服務商結算；建立索引、重建索引和語義查詢也可能產生 Embedding 呼叫費用。選用官方模型時，仍按對應的 BibGenie 計費規則處理。
BYOK 什麼時候適合你？
- 你已經有 provider API Key。
- 你希望費用由自己的 provider 帳戶承擔。
- 你需要使用機構內部模型服務。
- 你希望請求完全不經過 BibGenie 官方模型服務。
- 你想使用本地模型處理敏感材料。
- 你需要某個官方模型列表中暫時沒有的模型。
下一步
前往自訂模型，按照教程新增對話或 Embedding 模型、測試連線並選用。需要了解 Embedding 模型切換和索引重建時，參閱語義索引。