视频加标题字幕 API 接口文档接口基本信息接口名称视频加标题字幕 API接口描述为视频添加标题和字幕支持自定义标题样式、字幕位置、字体、颜色等参数适用于口播视频、微课视频、演讲解说视频等场景上线日期2026-09-20免费额度10 次按量计费单价1 元/分钟不足一分钟按秒扣费每日请求限制无限制接口地址https://#/api/aivideo/addtitlesubtitle返回格式application/json请求方式HTTP GET/POST请求示例https://接口地址?key你的key请求 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 字幕文字颜色默认 HFFFFFFASS 颜色代码subtitle_border_color 否 string H000000 字幕文字描边颜色默认 H000000ASS 颜色代码subtitle_outline 否 int 1 字幕描边大小默认 1值范围 0-4subtitle_shadow 否 int 0 字幕阴影默认 0值范围 0-3subtitle_alignment 否 int 2 字幕对齐方式默认 2底部居中可选值1左下、2底部居中、3右下、4左中、5居中、6右中、7左上、8顶部居中、9右上subtitle_font 否 int 1 字幕字体默认 1详见字体列表title_position 否 string top 标题位置可选值top顶部、bottom底部默认 toptitle_font_size 否 int 24 标题字号大小默认 24像素title_color 否 string HFFFFFF 标题文字颜色默认 HFFFFFFASS 颜色代码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 任务 IDdata.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 字幕文件 URLdata.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 没有成功记录 ID21001 模型 id 不存在21002 视频格式异常21003 音频格式异常21004 音频下载失败21005 视频下载失败21006 存在多人脸注意事项视频 URL 必须为可公开访问的地址支持 mp4、mov 等常见格式字幕文件支持 SRT 和 ASS 格式需确保 URL 可访问标题和字幕样式参数采用 ASS 颜色代码格式合成耗时与视频时长相关建议采用回调方式获取结果计费按视频实际时长计算不足一分钟按秒扣费来源酷虎云视频加字幕加标题加背景音乐api接口开放平台