获取切片知识点
更新时间：2026-05-26
POST
https://qianfan.baidubce.com/v2/knowledgeBase?Action=DescribeKeypoints
本接口获取文档切片的知识点信息，返回指定切片的知识点类型及内容，支持通过切片ID批量查询。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
chunkId
array
切片ID。 知识库文件中特定文本片段的唯一标识，需通过依次进入目标知识库、对应文件详情页，在切片列表中获取切片ID。
必选
显示子属性
隐藏子属性
items
string
请求结构
POST /v2/knowledgeBase?Action=DescribeKeypoints HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"knowledgeBaseId": "882181a4-****-30f2614e57ea",
"chunkId": ["882181a4-****-30f2614e57ea"]
}示例代码
curl
curl --location 'https://qianfan.baidubce.com/v2/knowledgeBase?Action=DescribeKeypoints' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer bce-v3/ALTAK********oq/5fe76a06b6c27aa3bc51a82507075435269f681a' \
--data '{
"knowledgeBaseId": "58d5ad28-****-4ce9-8d26-149680c1932e",
"chunkId": [
"2e2e6bf7-cbdb-4447-****-50f8a917943b",
"4b9168f4-8b37-4696-****-72b82309d529"
]
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
requestId
string
请求ID
可选
result
array
请求结果，请求成功时返回
可选
显示子属性
隐藏子属性
items
object {2}
显示子属性
隐藏子属性
chunkId
string
切片ID
可选
keypoints
array
返回知识点类型及内容
可选
显示子属性
隐藏子属性
items
object {2}
显示子属性
隐藏子属性
type
string
知识点类型
可选
content
string
知识点内容
可选
JSON
{
"requestId": "d92e5510-d6c0-4277-8500-6c9f0025af77",
"result": [
{
"chunkId": "064efa07-e993-4d06-81a9-01adc272f987",
"keypoints": [
{
"type": "en2ch",
"content": "!"
},
{
"type": "original",
"content": "对于旅游，我们其实没有太多时间，因为生活总是被很多琐碎填满，但山禾苑阔，太多美景值得我们出发前行，而旅途中遇见的人也好，事也罢，都将成为极为关键的一环，决定着这次旅途时你的心情。所以一款好的旅行产品就显得至关重要。"
},
{
"type": "faq",
"content": "为什么说一款好的旅行产品显得至关重要？"
},
{
"type": "original",
"content": "[](http://dd-21527.cdn.bcebos.com/uploads/images/pageimg/20230405/21527-2304052010408.jpg) !"
},
{
"type": "original",
"content": " \n\n!"
},
{
"type": "original",
"content": "[](http://dd-21527.cdn.bcebos.com/uploads/images/pageimg/20230405/21527-23040520100K.jpg) !"
},
{
"type": "spoken_query",
"content": "为什么说一款好的旅行产品就显得至关重要？"
},
{
"type": "original",
"content": "[](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsQAAA7EAZUrDhsAAAANSURBVBhXYzh8+PB/AAffA0nNPuCLAAAAAElFTkSuQmCC) !"
},
{
"type": "faq",
"content": "山禾苑有什么特点？"
},
{
"type": "spoken_query",
"content": "一款好的旅行产品的重要性"
},
{
"type": "original",
"content": "[](http://dd-21527.cdn.bcebos.com/uploads/images/pageimg/20230405/21527-2304052010241.jpg) !"
},
{
"type": "spoken_query",
"content": "没有太多时间去旅游的原因"
},
{
"type": "spoken_query",
"content": "为什么我们没有太多时间去旅游？"
}
]
}
]
}JSON
{
"code": "InvalidRequestArgumentError",
"message": "chunkId.0 Input should be a valid UUID, invalid group length in group 2: expected 4, found 3",
"requestId": "ea22dce8-1685-4f11-a84d-a3229339822d"
}评价此篇文章