LogoBibGenieドキュメント

カスタムモデル

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を使う場合
AnthropicAnthropic Claude APIを使う場合
xAIxAI Grok APIを使う場合
DeepSeek公式DeepSeek APIを使う場合
GoogleGemini APIを使う場合
GroqGroq APIを使う場合
Moonshot AIKimi / Moonshotモデルを使う場合
OpenRouterOpenRouter APIを使う場合
Alibaba通常はOpenAI Compatible経由
Z.AI / Zhipu AI通常はOpenAI Compatible経由
OllamaローカルOllamaサービスを使う場合
OpenAI CompatibleLM 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 やツール呼び出しの失敗が発生することがあります。

FAQ

On this page