资讯 文档
技术能力
语音技术
文字识别
人脸与人体
图像技术
语言与知识
视频技术

通用文件上传

接口描述

该接口用于用户上传文件,文件上传之后获取的文件id可以在多个场景使用。目前只能提交到指定知识库,其它场景后续会陆续开放。

权限说明

Authorization需要填写密钥。

接口定义

Path /v2/appbuilder?Action=UploadFile
Method POST
Content-Type mutlipart/form-data
Authorization 请求签名(此签名为应用工作台密钥)

请求结构

POST /v2/appbuilder?Action=UploadFile  HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: authorization string
Content-Type: mutlipart/form-data

file="北京小学.docx"

请求头域

除公共头域外,无其它特殊头域。

请求参数

字段 类型 是否必须 说明
file file 文件名限制命名不可包含 < > / \ | : " * ? 特殊符号,文件大小不能超过50MB

响应头域

除公共头域外,无其它特殊头域。

响应参数

字段 类型 必然存在 说明
requestId string requestId
id string 已上传文件id
name string 文件名称

请求curl 示例

curl --location 'https://qianfan.baidubce.com/v2/appbuilder?Action=UploadFile' \
--header 'Authorization: Bearer string' \
--form 'file=@"北京小学.docx"'

正确响应示例

HTTP/1.1 200 OK
{
  "requestId": "355a4f4e-a6d8-4dec-b840-7075030c6d22",
  "id": "1a1385ca-91ff-4b71-bb2a-048db17507c6",
  "name": "北京小学.docx"
}

错误响应示例

HTTP/1.1 400
{
  "requestId": "ae2225f7-1c2e-427a-a1ad-5413b762957d",
  "code": "InvalidRequestArgumentError",
  "message": "参数校验失败"
}