MeBox/115doc/115开放平台/API列表/视频播放/视频字幕列表.md

视频字幕列表

基本信息

属性	内容
接口名称	视频字幕列表
接口版本	v1.0
接口路径	/subtitle
请求方法	GET
接口状态	生产环境

接口说明

获取指定视频的自动载入字幕和可用字幕列表。

接口地址

https://proapi.115.com/open/video/subtitle

请求方式

GET

认证方式

Authorization: Bearer access_token

请求参数

参数名	类型	必填	默认值	说明	约束/示例
pick_code	string	是	-	视频文件提取码	b53gu6z3hvqji8wrm

请求示例

curl -G 'https://proapi.115.com/open/video/subtitle' \
  -H 'Authorization: Bearer <access_token>' \
  --data-urlencode 'pick_code=b53gu6z3hvqji8wrm'

响应字段说明

字段	类型	描述
state	boolean	操作结果状态，true：成功；false：失败
message	string	返回信息，成功时为空字符串
code	int	错误码
data	object	响应数据
data.autoload	object	默认自动载入的字幕；无可用字幕时为空数组
data.autoload.sid	string	字幕标识
data.autoload.language	string	字幕语言
data.autoload.title	string	字幕标题
data.autoload.url	string	字幕文件地址
data.autoload.type	string	字幕文件类型
data.autoload.key	string	内置字幕键，仅内置字幕返回
data.autoload.sha1	string	字幕文件哈希值
data.autoload.file_id	string	外挂或内嵌字幕文件ID
data.autoload.file_name	string	外挂或内嵌字幕文件名
data.autoload.pick_code	string	外挂或内嵌字幕文件提取码
data.autoload.caption_map_id	string	内嵌字幕映射ID
data.autoload.is_caption_map	int	是否为内嵌字幕，0：否；1：是
data.autoload.sync_time	float	字幕同步时间
data.autoload.from	int	记忆字幕来源标识
data.autoload.user_sub	int	是否为用户记忆字幕，1：是
data.list	object[]	字幕列表
data.list[].sid	string	字幕标识
data.list[].language	string	字幕语言
data.list[].title	string	字幕标题
data.list[].url	string	字幕文件地址
data.list[].type	string	字幕文件类型
data.list[].key	string	内置字幕键，仅内置字幕返回
data.list[].sha1	string	字幕文件哈希值
data.list[].file_id	string	外挂或内嵌字幕文件ID
data.list[].file_name	string	外挂或内嵌字幕文件名
data.list[].pick_code	string	外挂或内嵌字幕文件提取码
data.list[].caption_map_id	string	内嵌字幕映射ID
data.list[].is_caption_map	int	是否为内嵌字幕，0：否；1：是
data.list[].sync_time	float	字幕同步时间
data.list[].from	int	记忆字幕来源标识
data.list[].user_sub	int	是否为用户记忆字幕，1：是

响应示例

{
  "state": true,
  "message": "",
  "code": 0,
  "data": {
    "autoload": [],
    "list": []
  }
}

业务规则

• 用户记忆字幕不在列表中时会被前置；其余字幕按同目录同名外挂字幕、内嵌字幕、内置字幕、其他外挂字幕的顺序组合。
• 存在用户记忆字幕时优先将其作为自动载入字幕；否则依次选择内嵌字幕、同名外挂字幕或内置字幕。
• 字幕项来源不同，部分来源专属字段可能不返回。

注意事项

• access_token 通过 Authorization 请求头传递，请将请求示例中的占位符替换为实际访问令牌。
• 字幕文件地址具有时效性，请以本次接口返回值为准。

修改历史

修改时间	修改说明
2025年04月01日(周二) 00:00:00	创建文档