新增切片
更新时间：2026-04-02
POST
https://qianfan.baidubce.com/v2/knowledgeBase?Action=CreateChunk
为当前知识库中指定文档新增切片。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
documentId
string
文档ID
必选
knowledgeBaseId
string
知识库ID
必选
chunkType
string
切片类型
structured：结构化知识库text：默认项，非结构化知识库
可选
content
string
非结构化切片内容，当chunkType为text时，此项必填。
可选
fields
array
结构化数据切片内容，当chunkType为structured时，此项必填。
数组中的元素必须与表格型文档的表头列按顺序严格对齐。对于缺失值的字段，请务必传入空占位符（如 ""）。
示例："fields": ["张三", "", "北京"]。
可选
显示子属性
隐藏子属性
items
string
请求结构
POST /v2/knowledgeBase?Action=CreateChunk HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"knowledgeBaseId":"knowledgeBaseId",
"documentId": "documentID",
"chunkType": "text",
"content": "这里填写非结构化文本内容"
}示例代码
curl
curl --location 'https://qianfan.baidubce.com/v2/knowledgeBase?Action=CreateChunk' \
--header 'Authorization: Bearer <API Key>' \
--header 'Content-Type: application/json' \
--data '{
"knowledgeBaseId": "58d5ad28-****-4ce9-8d26-149680c1932e",
"documentId": "e96fb344-eadd-****-a546-d4165d81e432",
"chunkType": "structured",
"fields": [
"zhangsan",
"",
"北京"
]
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
id
string
切片ID
必选
requestId
string
请求ID
必选
JSON
HTTP/1.1 200 OK
{
"requestId": "f5fb7546-33d5-47ae-97e4-7b8ce9e02d55",
"id": "32d372f7-f112-49e1-a9bc-2001ea15e1a4"
}JSON
HTTP/1.1 401
{
"requestId": "ae2225f7-1c2e-427a-a1ad-5413b762957d",
"code": "PermissionDeniedError",
"message": "没有权限"
}评价此篇文章