视频加标题字幕 API 接口文档
接口基本信息
接口名称：视频加标题字幕 API
接口描述：为视频添加标题和字幕，支持自定义标题样式、字幕位置、字体、颜色等参数，适用于口播视频、微课视频、演讲解说视频等场景
上线日期：2026-09-20
免费额度：10 次
按量计费单价：1 元/分钟（不足一分钟按秒扣费）
每日请求限制：无限制
接口地址：https://#/api/aivideo/addtitlesubtitle
返回格式：application/json
请求方式：HTTP GET/POST
请求 HEADER：
名称 值
Content-Type application/x-www-form-urlencoded;charset:utf-8;
实名认证说明
使用前需完成实名认证，在控制台获取接口密钥（key）后方可调用。
提交任务请求参数说明
名称 必填 类型 示例值 说明
key 是 string 35kj5jnlj53453kl5j43nj5 接口密钥，在控制台->密钥管理查看
type 是 string start 固定值：start，提交任务类型
videourl 是 string https://#/#.mp4 视频 URL 地址，支持格式：mp4、mov 等
videotitle 否 string 视频标题 标题内容，支持内联样式参数，如 {视频标题参数=值}
subtitlefileurl 否 string https://#/#.srt 字幕文件 URL，支持 SRT 和 ASS 两种字幕格式
subtitle_y 否 int 100 字幕显示位置，底部边距，默认自适应
subtitle_font_size 否 int 10 字幕字号大小，默认 10（像素）
subtitle_color 否 string &HFFFFFF 字幕文字颜色，默认 &HFFFFFF（ASS 颜色代码）
subtitle_border_color 否 string &H000000 字幕文字描边颜色，默认 &H000000（ASS 颜色代码）
subtitle_outline 否 int 1 字幕描边大小，默认 1，值范围 0-4
subtitle_shadow 否 int 0 字幕阴影，默认 0，值范围 0-3
subtitle_alignment 否 int 2 字幕对齐方式，默认 2（底部居中），可选值：1左下、2底部居中、3右下、4左中、5居中、6右中、7左上、8顶部居中、9右上
subtitle_font 否 int 1 字幕字体，默认 1，详见字体列表
title_position 否 string top 标题位置，可选值：top（顶部）、bottom（底部），默认 top
title_font_size 否 int 24 标题字号大小，默认 24（像素）
title_color 否 string &HFFFFFF 标题文字颜色，默认 &HFFFFFF（ASS 颜色代码）
title_bg_color 否 string &H00000080 标题背景颜色，默认半透明黑色
callbackUrl 否 string https://#/callback/ 自定义回调 URL 地址。采用回调方式时，任务完成后将通过 POST 请求通知到该 URL；采用轮询方式时，需主动通过任务 ID 查询结果
查询任务请求参数说明
名称 必填 类型 示例值 说明
key 是 string 35kj5jnlj53453kl5j43nj5 接口密钥，在控制台->密钥管理查看
type 是 string query 固定值：query，查询任务类型
taskId 否 string a9b86729-4691-425f-8b6d-e4a88c0e9c91 任务 ID，通过提交任务接口返回
返回参数说明
名称 类型 说明
code int 状态码
msg string 状态信息
data object 请求结果数据集
data.taskId string 任务 ID
data.status string 任务状态：SUBMIT（已提交）、GENERATING（合成中）、SUCCESS（合成成功）、FAILED（合成失败）
data.failedCode string 错误代码：21000（没有成功记录 ID）、21001（模型 id 不存在）、21002（视频格式异常）、21003（音频格式异常）、21004（音频下载失败）、21005（视频下载失败）、21006（存在多人脸）等
data.failedMessage string 失败消息描述
data.videoUrl string 合成后的视频文件 URL 地址
data.duration string 视频时长，单位：秒
data.createTime string 创建时间
data.updateTime string 更新时间
data.subtitleFileUrl string 字幕文件 URL
data.md5 string 视频文件 MD5 值
data.debug string/array 调试数据
exec_time float 执行耗时
ip string 客户端 IP
返回示例
{
"code": 200,
"msg": "查询成功",
"data": {
"taskId": "a9b86729-4691-425f-8b6d-e4a88c0e9c91",
"status": "SUCCESS",
"failedCode": 0,
"failedMessage": "",
"videoUrl": "https://#/#.mp4",
"duration": 60,
"createTime": "2026-09-26T10:30:00",
"updateTime": "2026-09-26T10:30:45",
"subtitleFileUrl": "",
"md5": "78b35bb6b5f2b50e5438ed99fd7580d3"
},
"exec_time": 0.000548,
"ip": "1.204.205.30"
}
错误码说明
错误码 说明
21000 没有成功记录 ID
21001 模型 id 不存在
21002 视频格式异常
21003 音频格式异常
21004 音频下载失败
21005 视频下载失败
21006 存在多人脸
注意事项
视频 URL 必须为可公开访问的地址，支持 mp4、mov 等常见格式
字幕文件支持 SRT 和 ASS 格式，需确保 URL 可访问
标题和字幕样式参数采用 ASS 颜色代码格式
合成耗时与视频时长相关，建议采用回调方式获取结果
计费按视频实际时长计算，不足一分钟按秒扣费
来源：酷虎云视频加字幕加标题加背景音乐api接口开放平台