获取切片详情
更新时间：2026-04-21
POST
https://qianfan.baidubce.com/v2/knowledgeBase?Action=DescribeChunk
本接口用于获取指定切片详情。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
chunkId
string
切片ID。
知识库文件中特定文本片段的唯一标识，需通过依次进入目标知识库、对应文件详情页，在切片列表中获取切片ID。
必选
请求结构
POST /v2/knowledgeBase?Action=DescribeChunk HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"knowledgeBaseId": "knowledgeBaseID",
"chunkId": "chunkID"
}示例代码
curl
curl --location 'https://qianfan.baidubce.com/v2/knowledgeBase?Action=DescribeChunk' \
--header 'Authorization: Bearer <API Key>' \
--header 'Content-Type: application/json' \
--data '{
"chunkId": "bfbf0645-****-400f-bf0a-541fa5a44bbe",
"knowledgeBaseId":"8699955b-****-449f-a760-7362e817cd5c"
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
requestId
string
请求ID
必选
id
string
切片ID
必选
type
string
切片类型。
枚举值：
RAW：原文切片
NEW：新建切片
COPY：复制切片
必选
knowledgeBaseId
string
切片所属知识库ID
必选
documentId
string
切片所属文档ID
必选
content
string
切片内容
必选
row_line
array
表格型切片的行数据列表。非表格型切片时为空数组
必选
显示子属性
隐藏子属性
items
object {5}
显示子属性
隐藏子属性
key
string
列名（表头字段名）
可选
index
integer
列序号，从1开始
可选
value
string
该列对应的单元格内容
可选
enable_indexing
boolean
是否参与索引
可选
enable_response
boolean
是否参与回答
可选
wordCount
integer
切片内字符数量
必选
tokenCount
integer
切片内token数量
必选
enabled
boolean
是否生效
必选
status
string
切片状态。
枚举值：
Indexing：处理中
Indexed：已完成
必选
statusMessage
string
切片状态详细描述
必选
imageUrls
array
图片地址
必选
显示子属性
隐藏子属性
items
string
createTime
number
创建时间
必选
updateTime
number
更新时间
必选
JSON
{
"requestId": "1faba999-6721-4a68-9705-657aecb2d7a4",
"id": "bfbf0645-3d4b-400f-bf0a-541fa5a44bbe",
"type": "RAW",
"knowledgeBaseId": "8699955b-cc41-449f-a760-7362e817cd5c",
"documentId": "d87e3952-c21a-4ea9-b38b-9b29df649960",
"content": "<script id=\"API_DOC_DATA\" data-method=\"POST\" type=\"application/json\">{\"headInfo\":\"**调用该接口前：**\\n- 准备好需要干预的输入清单\\n- 准备好对应不同输入的回答（可选）\\n- 准备好对不同输入进行回答需要参考的知识库，并准备好知识库ID（可选）\\n- 在AppBuilder页面进行[创建知识库](https://cloud.baidu.com/doc/AppBuilder/s/mlz17z1iz) \\n- 通过OpenAPI进行[创建知识库](https://cloud.baidu.com/doc/AppBuilder/s/Om2sdgyns)\",\"debugUrl\":{\"url\":\"https://qianfan.baidubce.com/v2/ai_search/qa_strategy \",\"href\":\"\",\"method\":\"POST\"},\"debugDesc\":\"在调用百度AI搜索API进行联网搜索总结时，可设置一系列特定的用户输入，通过完全匹配、语义匹配或关键词匹配的方式命中后，进行特定知识库检索后总结、特定知识库检索+联网搜索后总结、预置特定回答等方式进行输出，确保符合品牌立场、人设、形象。",
"row_line": [],
"wordCount": 555,
"tokenCount": 426,
"enabled": true,
"status": "indexed",
"statusMessage": "None",
"imageUrls": [],
"createTime": 1765519532,
"updateTime": 1765519532
}JSON
{
"requestId": "77d27fc0-11f8-48be-a913-646b553c1954",
"id": "cd4f42a3-8c04-494d-a15a-7c2f4fd2bfda",
"type": "RAW",
"knowledgeBaseId": "58d5ad28-9ff9-4ce9-8d26-149680c1932e",
"documentId": "e96fb344-eadd-4842-a546-d4165d81e432",
"content": "中频 type 73 string 检索资源类型： web:网页 image:图像内容 video:视频内容 (×3) 知识库索引存储配置 (public | bes | vdb) (×2) 工具类型，取值function (×2)",
"row_line": [
{
"key": "推荐等级",
"index": 1,
"value": "中频",
"enable_indexing": false,
"enable_response": true
},
{
"key": "参数名",
"index": 2,
"value": "type",
"enable_indexing": true,
"enable_response": true
},
{
"key": "出现次数",
"index": 3,
"value": "73",
"enable_indexing": false,
"enable_response": true
},
{
"key": "数据类型",
"index": 4,
"value": "string",
"enable_indexing": false,
"enable_response": true
},
{
"key": "推荐描述 (Top1)",
"index": 5,
"value": "检索资源类型： web:网页 image:图像内容 video:视频内容 (×3)",
"enable_indexing": false,
"enable_response": true
},
{
"key": "备选描述 (Top2)",
"index": 6,
"value": "知识库索引存储配置 (public | bes | vdb) (×2)",
"enable_indexing": false,
"enable_response": true
},
{
"key": "备选描述 (Top3)",
"index": 7,
"value": "工具类型，取值function (×2)",
"enable_indexing": false,
"enable_response": true
}
],
"wordCount": 110,
"tokenCount": -1,
"enabled": true,
"status": "indexed",
"statusMessage": "None",
"imageUrls": [],
"createTime": 1775127668,
"updateTime": 1775127668
}评价此篇文章