> ## Documentation Index
> Fetch the complete documentation index at: https://enterprise-docs.dify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# モデルプロバイダー

> ワークスペースの AI モデルアクセスを設定する、すべてのアプリケーションを支える基盤

モデルプロバイダーは、ワークスペースに AI モデルへのアクセスを提供します。構築するすべてのアプリケーションには動作するためのモデルが必要であり、ワークスペースレベルでプロバイダーを設定することで、すべてのチームメンバーがすべてのプロジェクトでモデルを使用できます。

モデルプロバイダーは、OpenAI、Anthropic、Google などのサービスに対して独自の API キーを追加して設定します。完全な制御が可能で、各プロバイダーを通じて直接請求されます。

## プロバイダーの設定

ワークスペースの管理者とオーナーのみがモデルプロバイダーを設定できます。プロセスはプロバイダー間で一貫しています：

<Steps>
  <Step title="設定 → モデルプロバイダーに移動">
    ワークスペース設定でモデルプロバイダー設定にアクセスします。
  </Step>

  <Step title="プロバイダーを選択">
    OpenAI、Anthropic、Google、Cohere、またはその他のサポートされているプロバイダーから選択します。
  </Step>

  <Step title="認証情報を追加">
    API キーとプロバイダーが必要とするその他の設定を入力します。
  </Step>

  <Step title="テストして保存">
    Dify はプロバイダーをワークスペースで利用可能にする前に認証情報を検証します。
  </Step>
</Steps>

## サポートされているプロバイダー

**大規模言語モデル**：

* OpenAI (GPT-4, GPT-3.5-turbo)
* Anthropic (Claude)
* Google (Gemini)
* Cohere
* Ollama 経由のローカルモデル

**埋め込みモデル**：

* OpenAI Embeddings
* Cohere Embeddings
* Azure OpenAI
* ローカル埋め込みモデル

**専用モデル**：

* 画像生成 (DALL-E, Stable Diffusion)
* 音声 (Whisper, ElevenLabs)
* モデレーション API

## プロバイダー設定例

<Tabs>
  <Tab title="OpenAI">
    **必須**：OpenAI Platform の API キー

    **オプション**：Azure OpenAI またはプロキシ用のカスタムベース URL、組織スコープ使用のための組織 ID

    **利用可能なモデル**：GPT-4, GPT-3.5-turbo, DALL-E, Whisper, テキスト埋め込み
  </Tab>

  <Tab title="Anthropic">
    **必須**：Anthropic Console の API キー

    **利用可能なモデル**：Claude 3 (Opus, Sonnet, Haiku), Claude 2.1, Claude Instant
  </Tab>

  <Tab title="ローカル (Ollama)">
    **必須**：Ollama サーバー URL（通常は [http://localhost:11434）](http://localhost:11434）)

    **セットアップ**：Ollama をインストール、モデルをプル (`ollama pull llama2`)、Dify 接続を設定

    **メリット**：完全なデータプライバシー、外部 API 費用なし、カスタムモデルファインチューニング
  </Tab>
</Tabs>

## モデルの認証情報を管理

モデルプロバイダーの定義済みモデルやカスタムモデルに対して、複数の認証情報を追加し、それらの認証情報の切り替え、削除、変更を簡単に行うことができます。

以下のシナリオでは、複数のモデル認証情報を追加することをお勧めします。

* **環境の分離**：開発、テスト、本番など、環境ごとに別々のモデル認証情報を設定します。例えば、開発環境ではデバッグ用にレート制限のある認証情報を使用し、本番環境ではサービスの品質を確保するために、安定したパフォーマンスと十分なクォータを持つ有料の認証情報を使用します。

* **コストの最適化**：異なるアカウントやモデルプロバイダーから複数の認証情報を追加して切り替えることで、無料または低コストのクォータを最大限に活用し、アプリケーションの開発・運用コストを削減します。

* **モデルのテスト**：モデルのファインチューニングやイテレーションの過程で、複数のモデルバージョンを作成することがあります。これらの異なるバージョンの認証情報を追加することで、素早く切り替えてパフォーマンスのテストや評価を行うことができます。

<Tabs>
  <Tab title="定義済みモデル">
    モデルプロバイダーをインストールして最初の認証情報を設定した後、右上の **コンフィグ** をクリックして、以下の操作を実行します。

    * 新しい認証情報を追加する
    * すべての定義済みモデルのデフォルトとして認証情報を選択する
    * 認証情報を編集する
    * 認証情報を削除する

    <Note>
      デフォルトの認証情報を削除した場合は、手動で新しい認証情報を指定する必要があります。
    </Note>

    <Frame>
      <img src="https://mintcdn.com/dify-4171f9f9/UBmmoVHERrjglfCJ/images/use-dify/workspace/predefined-model-credential.png?fit=max&auto=format&n=UBmmoVHERrjglfCJ&q=85&s=6d4ebd8fa5e6108abf9433f350db881c" alt="事前定義モデルの認証情報を管理" width="1538" height="678" data-path="images/use-dify/workspace/predefined-model-credential.png" />
    </Frame>
  </Tab>

  <Tab title="カスタムモデル">
    ### 個別のカスタムモデルの認証情報を管理する

    モデルプロバイダーをインストールし、カスタムモデルを追加したら、以下の手順に従います。

    1. モデルリストで、対応する **コンフィグ** をクリックします。

    2. **モデルの資格情報を指定してください** パネルで、デフォルトの認証情報をクリックして認証情報リストを開き、次の操作を行います。

       * 新しい認証情報を追加する

       * 認証情報をそのカスタムモデルのデフォルトとして選択する

       * 認証情報を編集する

       * 認証情報を削除する

    <Warning>
      カスタムモデルの唯一の認証情報を削除すると、そのモデルも削除されます。
    </Warning>

    <Frame>
      <img src="https://mintcdn.com/dify-4171f9f9/UBmmoVHERrjglfCJ/images/use-dify/workspace/custom-model-credential.png?fit=max&auto=format&n=UBmmoVHERrjglfCJ&q=85&s=d68bad1fc8141fee43e3da1e0ea8e96f" alt="個別のカスタムモデルの認証情報を管理" width="1328" height="722" data-path="images/use-dify/workspace/custom-model-credential.png" />
    </Frame>

    <Info>
      既存のカスタムモデルと名前およびタイプが同一の新しいカスタムモデルを追加しようとすると、システムは重複したモデルを作成する代わりに、その既存モデルに新しい認証情報を追加します。
    </Info>

    ### すべてのカスタムモデルの認証情報を管理する

    **Manage Credentials** をクリックすると、すべてのカスタムモデルの認証情報を表示、編集、または削除できます。

    <Frame>
      <img src="https://mintcdn.com/dify-4171f9f9/UBmmoVHERrjglfCJ/images/use-dify/workspace/custom-model-credential-list.png?fit=max&auto=format&n=UBmmoVHERrjglfCJ&q=85&s=5ea53c4ed34c7c6e76fd15b43f0fc927" alt="すべてのカスタムモデルの認証情報を管理" width="1528" height="692" data-path="images/use-dify/workspace/custom-model-credential-list.png" />
    </Frame>

    カスタムモデルを削除した後も、その認証情報は **Manage Credentials** リストに残ります。**モデルの追加** をクリックすると、認証情報が残っている削除済みのカスタムモデルがすべて表示され、それらをすばやく再追加できます。

    <Frame>
      <img src="https://mintcdn.com/dify-4171f9f9/UBmmoVHERrjglfCJ/images/use-dify/workspace/removed-custom-model-re-add.png?fit=max&auto=format&n=UBmmoVHERrjglfCJ&q=85&s=f550dae3974ab628a171c2ca073df77a" alt="再追加しやすいよう削除済みモデルを表示" width="1534" height="564" data-path="images/use-dify/workspace/removed-custom-model-re-add.png" />
    </Frame>

    削除したカスタムモデルの認証情報をすべて **Manage Credentials** リストから削除した場合、そのモデルは **モデルの追加** をクリックしても表示されなくなります。
  </Tab>
</Tabs>

## 負荷分散

モデルプロバイダーに複数の認証情報がある場合、リクエストを自動的に分散できます。負荷分散によってトラフィックが分散され、単一の認証情報がレート制限に達することを防ぎ、高負荷時でもスループットを維持しやすくなります。

デフォルトでは、Dify はラウンドロビン方式を採用し、各リクエストをプール内の次の認証情報へ順番にルーティングします。ある認証情報がレート制限に達すると、その認証情報は 1 分間ローテーションから外され、その後で再試行されます。

設定手順：

1. モデルリストで対象のモデルを探し、対応する **コンフィグ** をクリックして **負荷分散** を選択します。
2. 負荷分散プールに認証情報を追加します。既存の認証情報から選択するか、新しく追加できます。
3. 認証情報を 2 つ以上有効にして、**保存** をクリックします。負荷分散が有効なモデルには専用のアイコンが表示されます。

<Frame>
  <img src="https://mintcdn.com/dify-4171f9f9/vMKCXdVD-5Kdilzi/images/add_load_balancing_credential.png?fit=max&auto=format&n=vMKCXdVD-5Kdilzi&q=85&s=256768f6904446580b6dc30f4e4468ea" alt="負荷分散プールに認証情報を追加" width="1194" height="872" data-path="images/add_load_balancing_credential.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/dify-4171f9f9/mZ12wIe1vYw_wFxp/images/load_balancing_icon.png?fit=max&auto=format&n=mZ12wIe1vYw_wFxp&q=85&s=e2eb7cd7da2b0deec279b61493a8e8d0" alt="負荷分散アイコンが付いたモデル" width="1564" height="358" data-path="images/load_balancing_icon.png" />
</Frame>

## アクセスと権限

チームアクセスはワークスペース権限に従います：

* **オーナー/管理者** はプロバイダーを設定、修正、削除できます
* **エディター/メンバー** は利用可能なプロバイダーを表示し、アプリケーションで使用できます

<Warning>
  API キーはワークスペース全体のモデルアクセスを許可し、各プロバイダーのアカウントを通じて直接請求が発生します。信頼できるチームメンバーにのみ管理者権限を与えてください。
</Warning>

## トラブルシューティング

**認証失敗**：API キーの正確性を確認し、有効期限をチェックし、十分なクレジットがあることを確認し、キーの権限を確認してください。

**モデルが利用できない**：プロバイダー設定にモデルが含まれていることを確認し、API キーのティアアクセスを確認し、プロバイダー設定を更新してください。

**レート制限**：プロバイダーアカウントをアップグレードし、リクエストキューイングを実装し、より高い制限のためにカスタムプロバイダーを検討してください。
