概述

使用此端点将上传的字幕与上传的视频关联。您可以在发推之前或之后将字幕和视频关联。

在将视频发推之前，关联字幕与视频的请求流为：1.使用分块上传的端点上传视频，然后获取视频 media_id。2.使用媒体类别设置为“Subtitles”（字幕）的分块上传端点上传字幕，然后获取字幕 media_id。3.调用此端点以将字幕关联到视频。4.利用视频 media_id 创建推文。

在将视频发推之后，关联字幕与视频的请求流为：1.使用分块上传的端点上传视频，然后获取视频 media_id。2.利用视频 media_id 创建推文。3.使用媒体类别设置为 SUBTITLES 的分块上传端点上传字幕，然后获取字幕 media_id。4.调用此端点以将字幕关联到视频。

请求

请求应为带有 JSON 内容正文和 Content-Type application/json; charset=UTF-8 的 HTTP POST

注意： 此端点的域为 upload.twitter.com

响应

此端点返回以下 HTTP 响应：

状态	文本	说明
200	确定	创建字幕的请求成功。
400	错误请求	通常，出现此响应是因为请求中存在无效的 JSON，或因为请求未能发送任何 JSON 有效负荷。在这种情况下，此错误可能表示字幕文件无效。
403	未经授权	HTTP 认证失败，因为凭据无效。检查自己的 OAuth 密钥和令牌。
404	未找到	接收请求的 URL 中未发现资源，可能是因为 media_id 错误
500	内部服务器错误	Twitter 方面出现了错误。使用指数回退模式重试请求。
503	服务不可用	Twitter 方面出现了错误。使用指数回退模式重试请求。

资源 URL

https://upload.twitter.com/1.1/media/subtitles/create.json

资源信息

响应格式	JSON
是否需要认证？	是（仅限用户情景）
是否存在速率限制？	是

示例请求

POST https://upload.twitter.com/1.1/media/subtitles/create.json

    {
      "media_id":"692797692624265216",
      "media_category":"TweetVideo",
      "subtitle_info": {
        "subtitles": [
          "media_id":"105195515189863968",
          "language_code":"EN", //The language code should be a BCP47 code (e.g. 'en", "sp"),
          "display_name":"English"
        ]
      }
    }

示例结果

// Successful response returns HTTP 2XX code without any content body.