VideoUpload - 上传本地视频

更新时间：2025-12-25

API访问域名

请求方式	POST
base url	https://keyue.cloud.baidu.com
后缀接口	/open/api/v2/file/upload
Authentication	token为API Key

请求参数

名称	类型	必选	中文名	说明
Content-Type	string	是	内容类型	固定值：application/json
token	string	是	API KEY	机器人API KEY。详细获取方式参考：准备工作
uid	string	是	用户ID	详细获取方式参考：准备工作
username	string	是	用户名	详细获取方式参考：准备工作

Body参数

说明：（multipart/form-data）方式

名称	类型	必选	中文名	说明
file	file	是	文件	待上传文件
agentId	string	否	Agent ID	为空则不绑定 Agent；有值时需存在，否则报 `AGENT_NOT_EXIST`
saveNameForKey	boolean	否	是否保留文件名为 key	默认 false；true 时使用原文件名作为存储 key

响应参数

名称	类型	必选	中文名	说明
time	integer	是	时间戳	毫秒级时间
data	object	是	数据	文件上传结果，详见data子数据
code	integer	是	状态码	200 为成功
msg	string	是	状态信息	OK 或错误描述

data子数据

名称	类型	必选	中文名	说明
key	string	是	文件key	上传后存储 key，可用于下载/预览
fileName	string	是	原始文件名	上传时的文件名

请求示例

                Bash
                
            

                curl --location POST 'https://keyue.cloud.baidu.com/open/api/v2/file/upload' \
--header 'token: xxxx' \
--header 'uid: xxxx' \
--header 'username: xxxx' \
--form 'file=@"xxx.mp4"' \
--form 'agentId="xxxx"' \
--form 'saveNameForKey="true"'
            

响应示例

            成功示例
        
            失败示例
        

            {
    "time": 1700000000000,
    "data": {
        "key": "upload/2024/03/01/xxx-uuid.pdf",
        "fileName": "report.pdf"
    },
    "code": 200,
    "msg": "OK"
}
        

            {
    "msg": "文件扩展名不合法",
    "code": 4001903
}
        

常见错误码

错误码	含义	说明
4000604	AGENT_NOT_EXIST	`agentId` 不存在
4001902	FILE_SIZE_NOT_ALLOWED	文件过大或大小非法（`FileUtil.preUploadCheck`）
4001903	FILE_EXTENDS_NAME_NOT_ALLOWED	扩展名在黑名单或不被允许
4001904	FILE_CONTENT_TYPE_NOT_ALLOWED	文件类型不被允许（`FileUtil.preUploadCheck`）
4001910	FILE_RECORD_OPERATOR_ERROR	记录/预览信息写入失败
4001912	FILE_UPLOAD_EXCEPTION	底层上传异常

WEB知识

VideoImport - 添加视频知识

百度智能云

客悦服务营销一站式应用平台

客悦服务营销一站式应用平台

VideoUpload - 上传本地视频

API访问域名

请求参数

Header参数

Body参数

响应参数

data子数据

请求示例

响应示例

常见错误码