接口说明

该接口用于上传视频文件到文件服务器，获取视频文件video_id（该 ID 为加密后的 ID）。该接口适用于抖音。

使用限制

抖音的 OAuth API 以https://open.douyin.com/ 开头。
超过 50MB 的视频建议采用分片上传，可以降低网关超时造成的失败。超过 300MB 的视频必须采用分片上传。视频总大小 4GB 以内。单个分片建议 20MB，最小 5MB。
为了更好的观看体验，推荐上传 16:9，分辨率为 720p（1280x720）及以上的竖版视频。
支持常用视频格式，推荐使用 mp4 、webm。
<span style="fo

基本信息

名称	描述
HTTP URL	https://open.douyin.com/api/douyin/v1/video/upload_video/
HTTP Method	POST
Scope	video.create.bind
权限要求	需要申请权限。路径：抖音开放平台控制台 > 应用详情 > 能力管理 > 能力实验室 > 代替用户发布内容到抖音需要用户授权

请求参数

请求头

access-token必填String

示例：act.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ

调用https://open.douyin.com/oauth/access_token/生成的token

Content-Type必填String

示例：multipart/form-data

固定值"multipart/form-data"

Query

open_id必填String

示例：ba253642-0590-40bc-9bdf-9a1334******

用户唯一标识。通过获取 access_token 获取。

Body

video必填Binary

视频文件

请求示例
curl --location --request POST 'https://open.douyin.com/api/douyin/v1/video/upload_video/?open_id=ba253642-0590-40bc-9bdf-9a1334******' \
--header 'access-token: act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ecuiuka******' \
--form 'video=@"/path/to/file"'

响应参数

Body展开全部子属性

dataStruct

展开子属性

extraStruct

展开子属性

响应示例
正常响应示例异常响应示例
{
  "data": {
    "video": {
      "video_id": "@9VxVx/WTUc8oLGK3atFqTs7912buPvyEOpZwrGXgL1MTbqer1nDhelpF4WnNgVhvD2bFzmUJfdQF3t2JTRfTOAJYf/3gzkjEE7EeLH******",
      "width": 720,
      "height": 1280
    },
    "error_code": 0,
    "description": ""
  },
  "extra": {
    "error_code": 0,
    "description": "",
    "sub_error_code": 0,
    "sub_description": "",
    "logid": "202008121419360101980821035705926A",
    "now": 1597213176393
  }
}

切换单列布局

错误码

HTTP 状态码	错误码	错误码描述	排查建议
200	2100005	参数错误	按照文档检查请求的Query、Header、Body
200	2190005	文件太大了	文件大小超过300MB
200	2100004	系统繁忙，此时请开发者稍候再试	重试，多次重试后仍有此报错请联系平台。
200	2114006	视频时长不能超过15分钟	视频时长不要超过15分钟

上传视频在线调试

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

上传视频