接口说明

该接口用于分片上传视频文件到文件服务器，完成上传。该接口适用于抖音。

使用限制

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

基本信息

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

请求参数

请求头

access-token必填String

示例：act.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ

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

content-type必填String

示例：application/json

固定值"application/json"

Query

open_id必填String

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

通过/oauth/access_token/获取，用户唯一标志

upload_id必填String

示例：@8hxdhauTCM

分片上传的标记。

请求示例
curl --location --request POST 'https://open.douyin.com/api/douyin/v1/video/complete_video_part_upload/?upload_id=@8hxdhauTCM&open_id=ba253642-0590-40bc-9bdf-9a1334******' \
--header 'access-token: act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ecuiuka2******' \
--header 'Content-Type: application/json' \
--data-raw ''

响应参数

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	2114020	uploadId无效	检查upload_id是否有效
200	2100004	系统繁忙，此时请开发者稍候再试	重试，多次重试后仍有此报错请联系平台。

开发者文档

分片上传完成

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

分片上传完成在线调试

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

分片上传完成