文件上传接口
更新时间:2024-12-26
接口说明
接口地址域名:https://open.xiling.baidu.com
用于上传形象克隆和声音克隆等接口需要的音视频文件,用户先调用上传接口上传文件,拿到 fileId 后在业务接口使用。
接口鉴权和通用字段说明请查阅:接口通用说明
接口列表
文件上传
接口说明
上传文件,返回文件Id。
接口协议
POST /api/digitalhuman/open/v1/file/upload
请求参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
file | MultipartFile | 是 | 文件内容,文件大小、格式等要求见业务接口的文档说明 |
providerType | String | 是 | 上传文件的业务类型,请参考具体业务接口的说明填写。 |
sourceFileName | String | 是 | 上传的文件名,必须填写正确的文件名称及后缀比如:test.mp4。 |
返回参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
fileId | String | 是 | 文件ID,后续用于业务接口,文件默认保存 7 天,请及时使用 |
fileName | String | 是 | 文件的原始名称,用户上传时的原文件名 |
请求示例
Postman 示例
Java 代码示例
Plain
1OkHttpClient client = new OkHttpClient().newBuilder()
2 .build();
3 RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM)
4 .addFormDataPart("file","664ddd142a021b7ca3ff7e94_217.wav",
5 RequestBody.create(MediaType.parse("audio/wav"),
6 new File("/Users/xxxx/Downloads/664ddd142a021b7ca3ff7e94_217.wav")))
7 .build();
8 Request request = new Request.Builder()
9 .url("https://open.xiling.baidu.com/api/digitalhuman/open/v1/file/upload?providerType"
10 + "=OPEN_CUSTOMIZATION_PICTURE&sourceFileName=1111.mp4")
11 .method("POST", body)
12 .addHeader("Authorization","your Authorization")
13 .build();
14 Response response = client.newCall(request).execute();
15 CommonResponse<FileStorageResponse> fileStorageResponseCommonResponse =
16 JsonUtil.readValue(response.body().string(), new TypeReference<CommonResponse<FileStorageResponse>>() {
17 });
18 System.out.println(JsonUtil.writeValueAsStringIgnoreNull(fileStorageResponseCommonResponse));
返回示例
Plain
1{
2 "code": 0,
3 "message": {
4 "global": "success"
5 },
6 "result": {
7 "fileId": "f2c1b49b-a62c-407b-95f8-5dd7085a44eb",
8 "fileName": "664ddd142a021b7ca3ff7e94_217.wav"
9 },
10 "requestId": "b3c53f39-cb78-4bab-abbf-077ecc12e3cf",
11 "success": true
12}
错误码
错误码 | 描述 |
---|---|
0 | 正常返回 |
4911 | 找不到app信息,请确认appId是否输入正确 |
4913 | 无法访问API,可能是app没有绑定对应的组件,或url输入错误,或访问的人像不可用 |
10001 | 签名校验失败 |
10002 | 签名信息为空 |
10003 | 签名格式错误 |
10004 | 未识别错误的通用错误码 |
10005 | 请求体JSON解析失败,请确认是否是合法的JSON格式 |
10006 | 参数校验不通过 |
10011 | 没有购买对应的商品 |
14001 | 内部服务异常,请稍后再试 |
14002 | 内部服务异常,网络拥堵 |
30001 | 用户上传文件解析异常 |
30002 | 获取文件宽高或时长异常 |
30003 | 上传文件类型异常 |
30004 | 上传文件大小超过最大限制 |
30005 | 上传文件时长超过最大限制 |
30006 | 上传文件像素数超过最大限制 |
30007 | 上传文件到bos异常 |