メインコンテンツへスキップ
Dify は、ナレッジベース、ドキュメント、チャンクをプログラムで管理するための完全なナレッジベース API セットを提供しています。データ同期の自動化や、ナレッジベース操作の CI/CD パイプラインへの統合に活用できます。 ナレッジベースを作成すると、API アクセスはデフォルトで有効になります。API 呼び出しを開始するには、エンドポイントとキーの API 認証情報のみが必要です。
1つのナレッジベース API キーで、同一アカウント配下のすべてのアクセス可能なナレッジベースを操作できます。意図しないデータ漏洩を防ぐため、認証情報は適切に管理してください。

API エンドポイントとキーの取得

Dify でナレッジベースページに移動します。右上の サービス API をクリックして API 設定パネルを開きます。ここでは以下の操作が可能です:
  • サービス API エンドポイントを取得します。これはすべてのナレッジベース API リクエストのベース URL です。
  • API キー をクリックして、新しいキーの作成や既存キーの管理を行います。
    API キーはサーバー側で安全に保管してください。クライアントサイドのコードや公開リポジトリには絶対に公開しないでください。

ナレッジベースの API アクセス管理

すべてのナレッジベースは、デフォルトでサービス API 経由でアクセス可能です。 特定のナレッジベースの API アクセスを制限するには、そのナレッジベースを開き、左下の API アクセス をクリックしてオフに切り替えます。

API リファレンス

エンドポイントの完全なリスト、リクエスト/レスポンスのスキーマ、エラーコード、インタラクティブな例については、ナレッジベース API リファレンスをご覧ください。