メインコンテンツまでスキップ

プロバイダーの追加

プロバイダーを追加すると、さまざまな LLM サービスを Elftia に接続し、チャット中にモデルを自由に切り替えられます。Elftia には、プリセットテンプレート、カスタム設定、インポート/エクスポートの 3 つの方法があります。

使用する場面​

  • Elftia を初めてセットアップしており、デフォルトプロバイダーを有効にするために API キーを設定する必要がある
  • デフォルトリストに含まれていない LLM サービスに接続する必要がある
  • 同じプロバイダーのインスタンスを複数追加したい(例: 異なるリージョンのエンドポイント)
  • 別のデバイスから設定を移行している

方法 1: プリセットテンプレートから追加する​

プリセットテンプレートには、プロバイダーの Base URL、デフォルトのモデルリスト、推奨設定が含まれています。API キーを入力するだけでセットアップを完了できます。

手順​

  1. Settings → Provider Management を開きます
  2. Add Provider ボタンをクリックします
  3. プロバイダー一覧からプリセットテンプレートを選択します
  1. 表示された設定パネルで API Key を入力します
    • キーの値を直接貼り付けます。例: sk-xxxxxxxxxxxxxxxx
    • または環境変数を参照します。例: $OPENAI_API_KEY
  1. Test Connection をクリックして、キーが有効であることを確認します

    • 成功: 緑色のメッセージ「Connection successful」が表示されます
    • 失敗: エラーメッセージが表示されます(トラブルシューティングを参照)
  2. Enabled トグルを有効にします

  3. Save をクリックします

完了すると、そのプロバイダーのモデルがチャット UI のモデル選択ドロップダウンに表示されます。

プリセットテンプレート一覧​

国際プロバイダー​

Preset ID名前API 形式Base URL特徴
openaiOpenAIopenaihttps://api.openai.com/v1/chat/completionsGPT-4o/5、o1/o3 reasoning シリーズ、vision サポート
anthropicAnthropicanthropichttps://api.anthropic.com/v1/messagesClaude Sonnet/Opus/Haiku 4.5、ネイティブな chain-of-thought
geminiGoogle Geminigooglehttps://generativelanguage.googleapis.com/v1beta/models/100 万トークンのコンテキスト、vision + reasoning
openai-responseOpenAI (Responses API)openai-responsehttps://api.openai.comGPT-5 シリーズ + o3/o4、新しい API
azure-openaiAzure OpenAIazure-openai(カスタム)エンタープライズ SLA。デプロイ名をモデルとして使用
openrouterOpenRouteropenaihttps://openrouter.ai/api/v11 つのキーで 200 以上のモデルを集約
groqGroqopenaihttps://api.groq.com/openai/v1超高速推論エンジン
ollamaOllamaopenaihttp://localhost:11434/v1ローカルデプロイ、無料で利用可能

中国のクラウドプラットフォーム​

Preset ID名前API 形式Base URL特徴
zhipuZhipu GLMopenaihttps://api.z.ai/api/paas/v4GLM-5/4.5/4.6V/4.7、Coding Plan
volcengineVolcengine (Ark)openaihttps://ark.cn-beijing.volces.com/api/v3Doubao Seed 2.0、インテリジェントルーティング、複数モデルの集約
kimiKimi (Moonshot)openaihttps://api.moonshot.ai/v1Kimi K2.5、256K コンテキスト
dashscopeAlibaba Cloud Bailianopenaihttps://dashscope.aliyuncs.com/compatible-mode/v1Qwen3 シリーズ、100 万トークン
tencentTencent Cloud Hunyuanopenaihttps://api.lkeap.cloud.tencent.com/v1Hunyuan 2.0、複数モデルの集約
minimaxMiniMaxanthropichttps://api.minimaxi.com/anthropicM2.5/M2.1、Anthropic 形式
baiduBaidu Qianfanopenaihttps://qianfan.baidubce.com/v2ERNIE シリーズ、Coding Plan
kuaishouKuaishou KwaiKATopenaihttps://wanqing.streamlakeapi.com/api/gateway/v1KAT-Coder、コーディング向けに最適化
mthreadsMoore Threadsopenai(設定が必要)国産チップ Coding Plan

方法 2: カスタム OpenAI 互換プロバイダー​

使用している LLM サービスが OpenAI 互換 API を提供している場合(ほとんどのサービスが該当します)、カスタムプロバイダーとして追加できます。

手順​

  1. Settings → Provider Management を開きます
  2. Add Provider をクリックし、Custom Provider を選択します
  1. 基本情報を入力します:
フィールド必須説明例
名前はい表示名My Local LLM
API 形式はいプロトコル形式を選択openai(最も一般的)
Base URLはいAPI アドレスhttp://localhost:8080/v1/chat/completions
API Keyいいえ認証キーsk-...(ローカルサービスでは空のままにできます)
  1. モデルを追加します:
    • Add Model をクリックします
    • モデル ID(API 呼び出し時に使用する名前。例: llama-3.1-70b)を入力します
    • 表示名を入力します
    • モデル機能フラグ(vision、function calling、reasoning など)を設定します
  1. (任意)Transformer を設定します:

    • 対象サービスの API が標準の OpenAI 形式と異なる場合は、適切な transformer を追加します
    • 一般的な選択肢: deepseek(DeepSeek 互換サービス向け)、groq(Groq 互換サービス向け)
  2. Test Connection をクリックして設定を検証します

  3. Enabled トグルを有効にして保存します

モデル検出​

一部のプロバイダーは、/v1/models エンドポイントによる自動モデル検出をサポートしています:

  1. プロバイダー設定で Model Discovery Endpoint(例: https://api.example.com/v1/models)を入力します
  2. Discover Models ボタンをクリックします
  3. Elftia がエンドポイントを呼び出してモデルリストを取得します
  4. 返された結果から追加したいモデルを選択します

方法 3: インポート / エクスポート​

設定をエクスポートする​

  1. Settings → Provider Management を開きます
  2. エクスポートしたいプロバイダーを選択します
  3. Export ボタンをクリックします
  4. 設定が JSON ファイルとして保存されます

設定をインポートする​

  1. Settings → Provider Management を開きます
  2. Import ボタンをクリックします
  3. 以前にエクスポートした JSON ファイルを選択します
  4. インポートされたプロバイダー情報を確認します
  5. API キーを入力します(セキュリティ上の理由により、エクスポートされたファイルには API キーは含まれません)
  6. 保存して有効化します

環境変数の API キー​

API キーの管理には環境変数を使用する方法を推奨します。特に次のような場合に有効です:

  • アプリケーションデータベースにキーを平文で保存したくない
  • 複数のデバイス間で設定ファイルを共有し、それぞれ異なるキーを使用する
  • Elftia を CI/CD や自動化シナリオで使用する

設定方法​

API キー入力フィールドに、先頭に $ を付けた環境変数名を入力します:

入力値実行時に解決される値
$OPENAI_API_KEYprocess.env.OPENAI_API_KEY の値
$ANTHROPIC_API_KEYprocess.env.ANTHROPIC_API_KEY の値
$MY_CUSTOM_KEYprocess.env.MY_CUSTOM_KEY の値

注: 対応する環境変数が設定されていない場合、API リクエストは認証エラーで失敗します。環境変数を変更した後は、新しい値を反映するために Elftia を再起動する必要があります。

設定リファレンス​

設定型デフォルト説明
名前String(テンプレート名)プロバイダーの表示名
API 形式Enumopenaiopenai / anthropic / google / azure-openai / openai-response
Base URLURL(テンプレートにより異なる)API リクエストアドレス。http:// または https:// で始まる必要があります
API KeyString(空)$ プレフィックスによる環境変数参照をサポート
モデルリストArray(テンプレートにより異なる)追加、削除、またはモデル検出による取得が可能
モデル検出エンドポイントURL(任意)/v1/models などのエンドポイントを呼び出し、モデルリストを自動取得します
EnabledBooleanfalse新しく追加されたプロバイダーはデフォルトで無効です
TransformerArray(形式により異なる)リクエスト/レスポンス形式の transformer チェーン
IconString(テンプレートにより異なる)プロバイダーアイコン識別子
Website linkURL(任意)プロバイダーの Web サイト。ドキュメントリンクに使用されます
NotesString(空)自由形式のメモ
API VersionString(Azure のみ)Azure OpenAI の API バージョン番号
Concurrency limitNumber(プロバイダーにより異なる)Agent モードでの最大同時リクエスト数
Is officialBooleanfalseプロバイダーを公式の Anthropic プロバイダーとしてマークします(chain-of-thought 署名の処理に影響します)

動作に関する注意​

プリセットテンプレートとカスタムプロバイダーの違い​

機能プリセットテンプレートカスタムプロバイダー
Base URL自動入力手動入力が必要
モデルリスト事前設定済み手動追加が必要
Transformer自動設定任意
モデル検出一部でサポートエンドポイントを手動設定する必要あり
Coding Plan一部でサポートサポートなし
検索連携事前設定済み手動設定が必要

プロバイダー ID の一意性​

各プロバイダーには一意の ID があります。同じプリセットテンプレートから複数のインスタンスを追加する場合、Elftia は ID にサフィックスを自動的に追加して一意性を確保します。

追加後の初期状態​

新しく追加されたプロバイダーはデフォルトで 無効 です。チャットでそのプロバイダーのモデルを使用する前に、次の操作が必要です:

  1. 有効な API キーを入力する
  2. 接続テストに成功する
  3. トグルを手動で有効にする

Troubleshooting​

問題考えられる原因解決策
接続テストが 401 を返すAPI キーが無効または期限切れプロバイダーの Web サイトでキーを再生成します
接続テストが 403 を返すキーに権限がないキーが対象モデルへアクセスできることを確認します
接続テストがタイムアウトするネットワーク接続がない、または Base URL が誤っているネットワーク接続と URL の綴りを確認します
$ENV_VAR キーが無効環境変数が設定されていないシステムで環境変数を設定し、Elftia を再起動します
モデル検出が空のリストを返すエンドポイントが誤っている、またはキーに権限がないモデル検出エンドポイント URL を確認し、キーに list-models 権限があることを確認します
保存が無効な URL エラーで失敗するBase URL の形式が正しくないhttp:// または https:// で始まっていることを確認します
カスタムプロバイダーのリクエストが失敗するTransformer 設定の不一致API 形式の選択が正しいことを確認するか、対応する transformer の追加を試します
Azure OpenAI 接続が失敗するAPI バージョンまたはデプロイ名が誤っているAPI Version フィールドが入力されていることを確認します(例: 2024-08-01-preview)。モデル名にはデプロイ名を使用します
MiniMax リクエスト形式エラーanthropic 形式を使用していないMiniMax は Anthropic API 形式を使用します。anthropic を選択し、anthropic transformer を設定します

関連ページ​

  • LLM Providers Overview - プロバイダーシステム全体のアーキテクチャ
  • API Key Pools - 1 つのプロバイダーに複数の API キーを設定する
  • Custom Endpoints - Ollama や LM Studio などのローカルサービスへ接続するための詳細ガイド
  • Model Parameters - temperature や max_tokens などの生成パラメーターを設定する