BibGenieドキュメントカスタムモデル
OpenAI、Anthropic、OpenRouter、Ollama、LM Studio、互換APIを含むカスタムモデルを追加・管理します。
カスタムモデルを使うと、自分のAPIキー、第三者プロバイダー、ローカルモデル、または所属機関のモデルサービスを利用できます。設定後、BibGenieはローカルZoteroプラグインから選択したプロバイダーへ直接リクエストを送信します。
モデルを追加する
BibGenieを開き、Model Settings に移動します。
Custom Modelsセクションで Add Model をクリックします。
Provider ID を選択または入力します。BibGenieはモデルカタログから一般的なプロバイダーを読み込み、可能な場合はProvider Name、Provider Type、Base URLを自動入力します。
Model ID を選択または入力します。モデルがカタログに存在する場合、BibGenieはModel Name、Family、Model Types、Context Window、Max Tokens、Descriptionを自動入力します。
API Keyを入力します。Ollamaなどのローカルサービスでは通常APIキーは不要です。
Test をクリックして接続を確認します。成功すると Connected と表示されます。失敗した場合、BibGenieはプロバイダーのエラーメッセージを表示するため、設定を修正できます。
自動入力されたフィールドを確認し、必要に応じてModel Types、Context Window、Max Tokensを調整します。
Add Model をクリックします。モデルが保存、有効化され、チャットのモデルセレクターで利用可能になります。
自動入力の動作
カスタムモデルの追加は完全な手作業ではありません。利用可能な場合、BibGenieは models.dev カタログからプロバイダーおよびモデル情報を読み込みます。
- Provider IDでは、一般的なプロバイダーの検索とカスタムプロバイダーの手入力ができます。
- プロバイダーを選択すると、Provider Name、Provider Type、Base URLが自動入力される場合があります。
- Model IDは選択したプロバイダーで絞り込まれ、カタログ内モデルとカスタムモデルIDの両方に対応します。
- カタログモデルを選択すると、Model Name、Family、Model Types、Context Window、Max Tokens、Description、価格メタデータが自動入力される場合があります。
- モデルカタログを読み込めない場合、BibGenieは内蔵のフォールバックプロバイダー一覧を使用し、それでもモデルを手動追加できます。
利用可能ならカタログ項目を優先
プロバイダーとモデルが検索ドロップダウンに表示される場合は、すべて手入力するのではなく選択してください。Provider Type、Base URL、モデル機能、コンテキスト上限のミスを減らせます。
フィールド
| フィールド | 必須 | 説明 |
|---|---|---|
| Provider ID | 必須 | openai、anthropic、openrouter などの一意なプロバイダー識別子。カスタムIDも対応 |
| Provider Name | 必須 | プロバイダーの表示名。通常はカタログから自動入力 |
| Model ID | 必須 | gpt-4.1 や claude-sonnet-4-5 など、プロバイダーAPIで使う実際のモデルID |
| Model Name | 必須 | BibGenie内で表示される名前。通常はカタログから自動入力 |
| API Key | 任意 | プロバイダーAPIキー。Ollamaなどのローカルプロバイダーでは通常不要 |
| Base URL | 任意 | APIエンドポイント。カタログプロバイダーでは多くの場合自動入力されますが、互換APIやローカルサービスでは手動確認が必要な場合があります |
| Provider Type | 必須 | OpenAI、Anthropic、Ollama、OpenAI CompatibleなどのAPI統合タイプ |
| 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モデルを使う場合 |
| OpenRouter | OpenRouter APIを使う場合 |
| Alibaba | 通常はOpenAI Compatible経由 |
| Z.AI / Zhipu AI | 通常はOpenAI Compatible経由 |
| Ollama | ローカルOllamaサービスを使う場合 |
| OpenAI Compatible | LM Studio、APIプロキシ、または所属機関の互換エンドポイントを使う場合 |
Base URL
多くの公式プロバイダーにはデフォルトのBase URLがあります。通常、Base URLを編集する必要があるのは次の場合です。
- OpenAI Compatibleを使う。
- APIプロキシを使う。
- ローカルモデルサービスを使う。
- プロバイダーがカスタムエンドポイントを要求する。
例：
https://api.openai.com/v1
https://openrouter.ai/api/v1
http://localhost:11434
http://localhost:1234/v1/v1パスに注意
多くの互換APIでは、Base URLが /v1 で終わる必要があります。バージョンパスが欠けていると、NetworkError、404、model-not-foundエラーが発生することがあります。
Ollamaの例
Ollamaがインストールされ、実行中であることを確認します。
ターミナルで
ollama list を実行し、ローカルモデルが利用可能であることを確認します。まだ実行されていない場合は、
ollama serve でOllamaを起動します。Listening on 127.0.0.1:11434 のような出力が表示されます。BibGenieでモデルを追加し、Provider Typeとして Ollama を選択します。
Base URLには
http://localhost:11434 を使用します。ollama list に表示されるモデル名、たとえば llama3.1:8b をModel IDとして使用します。LM Studioの例
LM Studioは通常、OpenAI Compatible経由で設定します。
LM StudioでローカルAPIサーバーを起動します。
BibGenieでモデルを追加し、Provider Typeとして OpenAI Compatible を選択します。
LM StudioのAPIアドレスをBase URLとして入力します。通常は
http://localhost:1234/v1 のような形式です。LM Studioで現在読み込まれているモデルのIDをModel IDとして入力します。
Model Types
モデルが実際に対応している機能に合わせて選択してください。
- Text：テキストチャット。通常は必須。
- Vision：画像、スクリーンショット、図の入力。
- Reasoning：複雑な推論タスクに有用。
- Function Calling：検索、読解、ライブラリ管理ワークフローに影響。
- Web Search：プロバイダーとモデルが対応している場合のみ有効化。
機能設定が正しくないと、ModelNotSupported やツール呼び出しの失敗が発生することがあります。