クエリトークンを作成
クエリを実行 用のクエリトークンを発行し、そのトークンとともに送信するリクエストボディを返します。詳細は ナレッジベースへのクエリ を参照してください。
curl --request POST \
--url https://{api_base_url}/knowledge-fs/spaces/{knowledge_base_id}/queries/admission \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"mode": "fast",
"query": "What changed in the refund policy this quarter?"
}
'{
"expires_at": "2026-09-06T08:31:07Z",
"operation_id": "createQuery",
"request": {
"activeDocumentIds": [],
"activeEntityIds": [],
"knowledgeSpaceId": "8d2c6a1e-5b3f-4c7d-9e01-2a3b4c5d6e7f",
"mode": "fast",
"query": "What changed in the refund policy this quarter?"
},
"token": "eyJhbGciOiJSUzI1NiIsImtpZCI6Imtmcy0yMDI2LTA5In0.eyJpc3MiOiJkaWZ5LWNvbnRyb2wtcGxhbmUiLCJhdWQiOiJrbm93bGVkZ2UtZnMiLCJzdWIiOiJkaWZ5LWRhdGFzZXQtYXBpLWtleTo3YjRjOWUyMS0zZDVmLTRhNmItOGM3ZC05ZTBmMWEyYjNjNGQiLCJhY3Rpb24iOiJxdWVyaWVzLmNyZWF0ZSIsInRyYWNlX2lkIjoiM2YxZTlhN2MtMmI0ZC00ZTZmLThhOTAtMWIyYzNkNGU1ZjYwIiwiZXhwIjoxNzg4NjgzNDY3fQ.V2s9Rm5xR2ZUZ0J2M2Q5aW1KU3hqUXJsV1pKcGtnQUFCZUtGMQ",
"trace_id": "3f1e9a7c-2b4d-4e6f-8a90-1b2c3d4e5f60",
"url": "https://api.example.com/v1/knowledge-fs/query-stream"
}Authorizations
すべてのリクエストは API キーで認証します：Authorization: Bearer {API_KEY}。アプリのエンドポイントにはアプリの API キーを、ナレッジのエンドポイントにはナレッジベースの API キーを使用します（Dify API クイックスタート）。
キーはサーバーサイドで保管し、クライアントコードには決して埋め込まないでください。キーが欠落または無効なリクエストは HTTP 401（unauthorized）で失敗します。
Path Parameters
ナレッジベース ID です。ナレッジベースの API アクセス ダイアログに表示されるサービス API エンドポイントの最後のセグメント（…/knowledge-fs/spaces/<knowledge base ID>）です。アドレスバーでは /datasets/new/ の後のセグメントです。
Body
不明なフィールドが含まれていると 400 が返ります。
nullable と記されたオプションフィールドでは、null は省略と同じ扱いになります。
空白のみではない query を指定してください。
質問です。空白のみではないクエリを指定してください。また、UTF-8 で 16,384 バイトまでに制限されます。
16000\Sこれらの ID は、検索されたコンテンツの絞り込みにも順位付けにも使われません。空のままにしてください。
100これらの ID は、検索されたコンテンツの絞り込みにも順位付けにも使われません。空のままにしてください。
100検索の深度です。fast、deep、research のいずれかを指定します（検索の深度 を参照）。省略する（または null を送信する）と、ナレッジベースのデフォルトの深度が使われます。これは ナレッジベース設定を取得 の retrieval.default_mode です。
fast, deep, research, null Response
クエリトークンが発行されました。
トークンの有効期限です（UTC の ISO 8601 タイムスタンプ）。発行から最大 60 秒後です。デプロイ環境によっては、有効期間がさらに短く設定されている場合があります。
常に createQuery で、トークンが有効な操作を示します。呼び出し元はこの値を無視して構いません。
Was this page helpful?
curl --request POST \
--url https://{api_base_url}/knowledge-fs/spaces/{knowledge_base_id}/queries/admission \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"mode": "fast",
"query": "What changed in the refund policy this quarter?"
}
'{
"expires_at": "2026-09-06T08:31:07Z",
"operation_id": "createQuery",
"request": {
"activeDocumentIds": [],
"activeEntityIds": [],
"knowledgeSpaceId": "8d2c6a1e-5b3f-4c7d-9e01-2a3b4c5d6e7f",
"mode": "fast",
"query": "What changed in the refund policy this quarter?"
},
"token": "eyJhbGciOiJSUzI1NiIsImtpZCI6Imtmcy0yMDI2LTA5In0.eyJpc3MiOiJkaWZ5LWNvbnRyb2wtcGxhbmUiLCJhdWQiOiJrbm93bGVkZ2UtZnMiLCJzdWIiOiJkaWZ5LWRhdGFzZXQtYXBpLWtleTo3YjRjOWUyMS0zZDVmLTRhNmItOGM3ZC05ZTBmMWEyYjNjNGQiLCJhY3Rpb24iOiJxdWVyaWVzLmNyZWF0ZSIsInRyYWNlX2lkIjoiM2YxZTlhN2MtMmI0ZC00ZTZmLThhOTAtMWIyYzNkNGU1ZjYwIiwiZXhwIjoxNzg4NjgzNDY3fQ.V2s9Rm5xR2ZUZ0J2M2Q5aW1KU3hqUXJsV1pKcGtnQUFCZUtGMQ",
"trace_id": "3f1e9a7c-2b4d-4e6f-8a90-1b2c3d4e5f60",
"url": "https://api.example.com/v1/knowledge-fs/query-stream"
}