上传视频

Scope: video.create 需要申请权限需要用户授权该接口用于上传视频文件到文件服务器，获取视频文件video_id（该 ID 为加密后的 ID）。该接口适用于抖音。

注意：

抖音的OAuth API以https://open.douyin.com/开头。
超过50m的视频建议采用分片上传，可以降低网关超时造成的失败。超过128m的视频必须采用分片上传。视频总大小4GB以内。单个分片建议20MB，最小5MB。

视频文件要求：

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

状态码排查

进入【状态码排查工具】

请求地址

POST /video/upload/

请求头

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

请求参数

URL 请求

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

暂无数据

Body 请求

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

暂无数据

请求样例

响应参数

参数名称	参数类型	参数描述	参数示例

暂无数据

响应样例

{
  "data": {
    "error_code": 0,
    "description": "",
    "video": {
      "video_id": "v0200f450000bn8c6aa0ifki8fikg1b0",
      "width": 720,
      "height": 1280
    }
  },
  "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"
  }
}

诚邀您对本文档易读易用性进行评价

好用

不好用