分块视频 media/upload 示例

使用分块 POST media/upload 端点需要调整单个图像上传的工作流程。对于视频或分块上传,您必须:

  • 使用 INIT 命令初始化上传
  • 使用 APPEND 命令上传每个字节分块
  • 使用 FINALIZE 命令完成上传

参阅大型视频上传示例,获取用 Python 编写的示例。

下面是一个使用命令行 twurl 实用工具的工作示例。要查看使用 twurl 时请求和响应的完整标头,请使用 -t 选项启用跟踪模式。

 

INIT

      twurl -H upload.twitter.com "/1.1/media/upload.json" -d "command=INIT&media_type=video/mp4&total_bytes=4430752"
    
      {
  "media_id": 601413451156586496,
  "media_id_string": "601413451156586496",
  "expires_after_secs": 3599
}
    

APPEND

      twurl -H upload.twitter.com "/1.1/media/upload.json" -d "command=APPEND&media_id=601413451156586496&segment_index=0" --file /path/to/video.mp4 --file-field "media"
    

成功上传后,HTTP 2XX 将与空白的响应正文一同返回。

 

FINALIZE

      twurl -H upload.twitter.com "/1.1/media/upload.json" -d "command=FINALIZE&media_id=601413451156586496"
    
      {
  "media_id": 601413451156586496,
  "media_id_string": "601413451156586496",
  "size": 4430752,
  "expires_after_secs": 3600,
  "video": {
    "video_type": "video/mp4"
  }
}
    

疑难解答

有关媒体 API 的问题: