批量上传视频到素材中心
- 一次上传视频的数量限制50个;
- 每个视频大小限200M;
- 接口同步接受上传视频的请求,异步处理:视频的下载、格式校验、审核等过程;
- 视频的审核时间根据素材中心素材数量而定,大部分视频在1分钟内能审核完,小部分视频审核时间会达到天级别,请耐心等待
- 审核拒绝的视频将在15日内被定期清理,请慎用。
6.上传时需要关注文件夹属性,只有0(文件夹)和2(视频文件夹)才可以上传视频。文件夹属性可通过【/material/getFolderInfo】和【/material/searchFolder】查看。
其他问题请参考:https://op.jinritemai.com/docs/guide-docs/171/1719
请求URL:
POST https://kf.fw199.com/gateway/dd/material/batch/upload/video/async
公共参数
参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
---|---|---|---|---|
appid | String | 是 | 合作伙伴AppId | |
timestamp | String | 是 | 1657525936 | 当前Unix时间戳,秒 |
seller_nick | String | 是 | 38173182 | 抖店的账号,对应蜂巢授权返回doudianseller字段 |
sign | String | 是 |
业务参数
参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
---|---|---|---|---|
+materials | List | 是 | - | 素材信息 |
- request_id | String | 是 | 123456789 | 该参数仅有2个作用:(1)一次请求中素材的唯一标示;(2)接口防并发,规则是:不同请求所有request_id排序之后拼接起来,若相同视为同一次请求 |
- folder_id | String | 是 | 0 | 文件夹id,“0”为素材中心根目录。若想创建文件夹,请参考:创建文件夹文档 |
- name | String | 是 | 这是一个视频.mp4 | 素材名称,长度限制为50个字符,最好带上后缀 |
- url | String | 否 | https://origin/xxxx | 视频url。如果是二进制上传,请使用file_uri字段。url和file_uri二选一,不能同时为空 |
- file_uri | - | 否 | tos-cn-i-7veqoeduo3/9e1df78… | 二进制文件对应的uri,获取方式请参考:二进制上传素材指南 |
- material_type | String | 是 | video | 素材类型,请传固定值:video |
2. 请求示例代码(Java)
请求示例代码
@Test
public void DDMaterialBatchuploadVideoasync() throws Exception {
Map<String, Object> data = new HashMap<String, Object>();
data.put("appid", Config.AppId);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
data.put("seller_nick", Config.DDSellerNick);
data.put("materials","[\n" +
" {\n" +
" \"request_id\": \"123456789\",\n" +
" \"folder_id\": \"73691281073984637961425\",\n" +
" \"name\": \"test123.mp4\",\n" +
// " \"url\": \"https://origin/xxxx\",\n" +
" \"file_uri\": \"tos-cn-i-7veqoeduo3/deadd2377fa341f194a398979bad9d9a.mp4\",\n" +
" \"material_type\": \"video\"\n" +
" }\n" +
" ]" );
data.put("sign", Sign(data,Config.AppSecret));
// 调用服务API
String resp = doHttpRequest(Config.DDMaterialBatchUploadVideoAsync, data);
System.out.println(resp);
}
3. 返回结果如下:
{
"code": 0,
"message": "ok",
"data": {
"failed_map": {},
"success_map": {}
},
}
说明: code为0表示成功,非0为失败,message会包含失败原因。返回字段说明见文档
https://op.jinritemai.com/docs/api-docs/69/1617
文档更新时间: 2024-05-22 13:50 作者:JSL