> ## Documentation index > Fetch the complete documentation index at: https://dify-docs.docs7.io/llms.txt > Ask it with GET https://dify-docs.docs7.io/ask?q=. Short keywords rank best. > Use these to discover all available pages before exploring further. # ナレッジベース API > 2 つのナレッジベース API に共通の API キーの作成とアクセス範囲の設定、安全な置き換え、呼び出しが拒否された原因の確認 > このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、[英語版](/en/api-reference/guides/knowledge-base-api) を参照してください。 ナレッジベースの種類ごとに API が分かれていますが、どちらも同じ API キーを使います。 - [Agent ナレッジベース API](/ja/api-reference/guides/knowledge-base) Cloud - [従来型ナレッジベース API](/ja/api-reference/guides/knowledge) ## API キーの作成 {#create-an-api-key} キーを作成、表示、削除できるのは、ワークスペースのオーナーと管理者だけです。 **ナレッジ** 画面で右上の **サービスAPI** をクリックし、続けて **APIキー** をクリックします。1 つのワークスペースで作成できるキーは最大 10 個です。 同じパネルには、両方の API のベース URL であるサービス API エンドポイントも表示されます。 ## アクセス範囲の選択 {#choose-a-scope} キーの作成時に、すべてのナレッジベースへのアクセスを許可するか、選んだナレッジベースだけに限定するかを決めます。選べるのはどちらの種類のナレッジベースでもかまいません。連携先が扱うナレッジベースだけを選んでください。 特定のナレッジベースを指定しない操作も呼び出す場合は、代わりにすべてのナレッジベースへのアクセスを許可します。従来型ナレッジベースの一覧取得や作成、タグの管理、[利用可能なモデルの取得](/ja/api-reference/models/get-available-models) などがこれにあたります。 アクセス範囲は後から変更できません。変更が必要な場合は、[キーを置き換えてください](#replace-a-key)。 ## キーの置き換え {#replace-a-key} キーのアクセス範囲を変更する場合やキーをローテーションする場合は、新しいキーを作成して連携先を切り替えてから、古いキーを削除します。削除したキーはすぐに使えなくなります。 Agent ナレッジベースのリサーチタスクと削除ジョブは、それを開始したキーでしか読み取れません。古いキーを削除する前に、それらの完了を待ち、結果を読み取っておいてください。 ## キーが拒否される場合 {#when-a-key-is-refused} | 原因 | 従来型ナレッジベース | Agent ナレッジベース | |:--|:--|:--| | ナレッジベースがキーのアクセス範囲外にある | 403 `forbidden` | 403 `knowledge_fs_access_denied` | | アクセス範囲を限定したキーで、ナレッジベースを指定しない操作を呼び出した | 403 `forbidden` | 403 `forbidden` | | ナレッジベースの **API アクセス** がオフになっている | 403 `forbidden` | 403 `knowledge_fs_access_denied` | | キーが直接削除された、または対象だった唯一のナレッジベースとともに削除された | 401 `unauthorized` | 401 `unauthorized` | | Dify Cloud で、ワークスペースが [リクエストレート制限](/ja/cloud/use-dify/knowledge/knowledge-request-rate-limit) に達した | 403 `forbidden` | 403 `forbidden` | 従来型ナレッジベースの 403 `forbidden` は上記のいくつかの原因で返るため、エラーの `message` を読んで区別してください。 従来型ナレッジベースにアクセス範囲を限定したキーは、そのナレッジベースからアップグレードした Agent ナレッジベースには使えません。Agent ナレッジベースにアクセスするには、それを含むキーに [置き換えてください](#replace-a-key)。 キーのワークスペースに存在しない Agent ナレッジベース ID を指定すると、無効なキーと同じく 401 `knowledge_fs_invalid_credential` が返ります。キーを置き換える前に、ID を確認してください。