VideoImport - 添加视频知识
更新时间：2025-12-11
API访问域名
| 请求方式 | POST |
|---|---|
| base url | https://keyue.cloud.baidu.com |
| 后缀接口 | /open/v1/api/v2/llm/video/import |
| Authentication | token为API Key |
请求参数
Header参数
| 名称 | 类型 | 必选 | 中文名 | 说明 |
|---|---|---|---|---|
| Content-Type | string | 是 | 内容类型 | 固定值：application/json |
| token | string | 是 | API KEY | 机器人API KEY。 详细获取方式参考：准备工作 |
| uid | string | 是 | 用户ID | 详细获取方式参考：准备工作 |
| username | string | 是 | 用户名 | 详细获取方式参考：准备工作 |
Body参数
| 名称 | 类型 | 必选 | 中文名 | 说明 |
|---|---|---|---|---|
| type | string | 是 | 导入类型 | 枚举： FILE（本地文件上传，走 fileItemList） URL（在线URL上传，走 urlItemList） |
| fileItemList | array | 否 | 文件项列表 | type=FILE 时必填；元素结构见fileItemList子数据 |
| urlItemList | array | 否 | URL 项列表 | type=URL 时必填；数量≤50，元素结构见urlItemList子数据 |
| taskExtend | string | 否 | 任务扩展参数 | 为空代表"{}"：自动分段与数据清洗。有值代表： 1、分段标识符split_by：换行切分punc、标点切分wrap 2、分段最大长度chunk_size（200-800） 3、分段重叠比overlap_proportion（0-20） 4、文本预处理（删除连续空格、换行、制表符）：pre_handle_text 5、文本预处理（删除目录、页眉、页脚）：pre_handle_directory |
| dirId | string | 是 | 目录ID | 用于归档知识 |
| knowledgePublic | int | 否 | 知识范围 | 0 内部知识；1 公共知识 |
| i18n | int | 否 | 国际化 | 0 非国际化；1 国际化 |
| forceCoverage | int | 否 | 强制覆盖 | 0 否；1 是 |
fileItemList子数据
| 名称 | 类型 | 必选 | 中文名 | 说明 |
|---|---|---|---|---|
| fileName | string | 是 | 文件名 | 视频原始名 |
| fileKey | string | 是 | 文件key | 通过文件上传接口获得 |
| desc | string | 否 | 描述 | 视频描述 |
| id | string | 否 | 视频ID | 传值则尝试更新对应视频 |
urlItemList子数据
| 名称 | 类型 | 必选 | 中文名 | 说明 |
|---|---|---|---|---|
| url | string | 是 | 视频URL | 视频访问地址 |
| id | string | 否 | 视频ID | 为空则新增；有值则更新 |
| desc | string | 否 | 描述 | 视频描述 |
| fileName | string | 否 | 文件名 | 视频名称 |
响应参数
| 名称 | 类型 | 必选 | 中文名 | 说明 |
|---|---|---|---|---|
| Body | Resource | 是 | 资源 | 成功时为 JSON（空对象）；存在失败项时为 txt 文件（失败列表） |
| Headers | string | 是 | 提示消息 | 成功时MESSAGE 头包含“成功/跳过”提示；失败时带 Content-Disposition: attachment;filename=导入失败文件_xxx.txt |
| HTTP Code | int | 是 | 状态码 | 200 成功或部分成功；400 当全部失败 |
请求示例
Bash
1curl --location 'https://keyue.cloud.baidu.com/open/v1/api/v2/llm/video/import' \
2--header 'Content-Type: application/json' \
3--header 'token: xxxx' \
4--header 'uid: xxxx' \
5--header 'username: xxxx' \
6--data '{
7 "type": "FILE",
8 "dirId": "0",
9 "knowledgePublic": 0,
10 "i18n": 0,
11 "forceCoverage": 0,
12 "fileItemList": [
13 {
14 "fileName": "xxxx.mp4",
15 "fileKey": "Yxxxxxx",
16 "desc": "介绍视频"
17 }
18 ]
19}'响应示例
1{}1响应为 txt 附件
2导入失败列表
3文件格式不支持: sample.mp4常见错误码
| 错误码 | 含义 | 说明 |
|---|---|---|
| 4001950 | TASK_IS_RUNNING | 租户并发上传超过限制 |
| 4007335 | TENANT_DOCUMENT_UPLOADING | 租户上传队列拥塞 |
| 4001903 | FILE_EXTENDS_NAME_NOT_ALLOWED | 文件扩展名非法 |
| 4001902 | FILE_SIZE_NOT_ALLOWED | 文件大小非法 |
| 4001904 | FILE_CONTENT_TYPE_NOT_ALLOWED | 文件类型非法 |
| 4002012 | VIDEO_IMPORT_ERROR | 导入参数/数量校验失败 |
| 4002014 | LARGE_MODEL_FILE_EMPTY | 无有效导入项 |