批量上传视频到素材中心

  1. 一次上传视频的数量限制50个;
  2. 每个视频大小限200M;
  3. 接口同步接受上传视频的请求,异步处理:视频的下载、格式校验、审核等过程;
  4. 视频的审核时间根据素材中心素材数量而定,大部分视频在1分钟内能审核完,小部分视频审核时间会达到天级别,请耐心等待
  5. 审核拒绝的视频将在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