调用Twitter media/subtitles/create接口添加视频字幕遇系列报错求解答

1. 修复JSON语法错误 #

你的请求参数里subtitles数组格式存在问题，数组内的字幕项必须是对象，需要用大括号包裹。当前写法会导致API无法正确解析参数结构，进而引发参数识别类错误。

修正后的参数示例：

{
  "media_id": "692797692624265216",
  "media_category": "TweetVideo",
  "subtitle_info": {
    "subtitles": [
      {
        "media_id": "105195515189863968",
        "language_code": "en",
        "display_name": "English"
      }
    ]
  }
}

2. 修正语言代码格式 #

按照BCP47规范，语言代码必须使用小写格式（比如en而非EN），大写格式可能导致API无法识别，触发参数相关异常。

3. 处理media_id的字符串类型问题 #

错误提示提到media_id_string，说明API期望接收字符串类型的media_id。确保你的media_id参数始终以字符串传递——如果请求工具自动将大数字转为数字类型，可能会导致精度丢失或参数不匹配，引发media_id_string未定义的错误。

4. 确认请求头设置 #

必须将请求的Content-Type设为application/json，否则API无法正确解析JSON格式的参数，会出现各种参数未定义的异常。

5. 验证媒体资源关联性 #

• 确认视频的media_id和字幕文件的media_id都属于同一个开发者账号与用户会话
• 确保视频的media_category确实是TweetVideo，且该媒体资源是已成功上传的有效视频

6. 检查API版本兼容性 #

Twitter API v1.1和v2的接口参数差异较大，确认你调用的media/subtitles/create对应正确的API版本，参考对应版本的官方文档核对参数（注意部分旧文档可能未及时更新细节）。

内容的提问来源于stack exchange，提问作者SANDHYA LATHA