获取知识库切片列表。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求语法
GET /api/v1/langstudio/knowledgebases/{KnowledgeBaseId}/knowledgebasechunks HTTP/1.1
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| KnowledgeBaseId | string | 是 | 知识库 ID。 | d-ab****89 |
| VersionName | string | 否 | 知识库版本。默认为 v1。 | v1 |
| MetaData | object | 否 | 原始文件信息。为空表示遍历整个知识库版本。 | |
| FileUri | string | 否 | 文件地址。若同时传入 FileMetaId 则忽略此参数值。 | oss://mybucketpath/file1.txt |
| FileMetaId | string | 否 | 文件元数据 ID。 | xd8e****79du |
| ChunkStatus | string | 否 | 切片状态。
| Enable |
| PageNumber | integer | 否 | 当前页数。 | 1 |
| PageSize | integer | 否 | 每页查询数量。 | 20 |
返回参数
示例
正常返回示例
JSON格式
{
"KnowledgeBaseChunks": [
{
"KnowledgeBaseChunkId": "123e4567-e89b-12d3-a456-426655440000",
"KnowledgeBaseId": "d-ix****o9",
"VersionName": "v1",
"ChunkStart": 0,
"ChunkEnd": 30000,
"ChunkSequence": 1,
"ChunkContent": "content",
"ChunkSize": 1873,
"ChunkStatus": "Enable",
"DownloadUrl": "https://mybucket.oss-cn-shanghai.aliyuncs.com/...",
"ThumbnailUrl": "https://mybucket.oss-cn-shanghai.aliyuncs.com/...",
"ChunkAttachment": [
{
"PlaceholderId": "IMAGE_PLACEHOLDER_0",
"Type": "image",
"Uri": "oss://mybucket/path/file.txt",
"DownloadUrl": "https://mybucket.oss-cn-shanghai.aliyuncs.com/..."
}
],
"MetaData": {
"FileName": "file1.txt",
"FileUri": "oss://mybucketpath/file1.txt",
"FileMetaId": "xd8e****79du"
}
}
],
"MaxResults": 10,
"TotalCount": 25,
"RequestId": "963BD7F9-0C02-5594-9550-BCC6DD43E3C0"
}错误码
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2026-01-14 | 新增 OpenAPI | 查看变更详情 |