POST media/subtitles/create

概述

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

在将视频发推之前,关联字幕与视频的请求流为: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.

Was this document helpful?

感谢

谢谢你的反馈。我们真的很高兴能帮上忙!

Thank you for the feedback. How could we improve this document?

Thank you for the feedback. Your comments will help us improve our documents in the future.