分片上传视频

Scope: toutiao.video.create 需要申请权限 需要用户授权 该接口用于分片上传视频文件到文件服务器,先初始化上传获取upload_id。该接口适用于头条。

注意:

  • 超过50m的视频建议采用分片上传,可以降低网关超时造成的失败。超过128m的视频必须采用分片上传。视频总大小300MB以内。单个分片建议20MB,最小5MB。
  • 注意参数中upload_id作为url参数时,必须encode,只对upload_id进行encode

视频文件要求:

  • 为了更好的观看体验,推荐上传16:9,分辨率为720p(1280x720)及以上的竖版视频。
  • 支持常用视频格式,推荐使用 mp4 、webm。
  • 带品牌logo或品牌水印的视频,会命中头条的审核逻辑,有比较大的概率导致分享视频推荐降权处理/分享视频下架处理/分享账号被封禁处理。强烈建议第三方应用自行处理好分享内容中的不合规水印。
  • 视频审核逻辑与端上一致。

状态码排查

进入【状态码排查工具】

请求地址

POST /toutiao/video/part/upload/

请求头

  • Content-Type: multipart/form-data
  • access-token: 调用/oauth/access_token/生成的token,此token需要用户授权。示例: act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ecuiuka27L56lr

请求参数

URL 请求

参数名称参数类型参数描述参数示例是否必填
暂无数据

Body 请求

参数名称参数类型参数描述参数示例是否必填
暂无数据

请求样例

响应参数

参数名称参数类型参数描述参数示例
暂无数据

响应样例

{
  "extra": {
    "error_code": 0,
    "description": "",
    "sub_error_code": 0,
    "sub_description": "",
    "logid": "202008121419360101980821035705926A",
    "now": 1597213176393
  }
}

响应错误样例

{
  "data": {
    "error_code": 2100005,
    "description": "Parameter error"
  },
  "extra": {
    "error_code": 2100005,
    "description": "Parameter error",
    "sub_error_code": 0,
    "sub_description": "",
    "now": 1594015876138,
    "log_id": "2020070614111601022506808001045D59"
  }
}
诚邀您对本文档易读易用性进行评价
好用
不好用