视频加字幕怎么制作
视频加字幕的制作流程，本质上就是通过接口提交视频与字幕参数，然后轮询或等待回调获取合成结果。下面结合你提供的接口文档，为你整理一份详细的操作指南。
🛠️ 准备工作
在开始之前，请确保你已经准备好以下内容：
接口密钥（key）：在控制台密钥管理中获取。
视频文件：必须是有声视频，格式支持 mp4、mov 等，并已上传至可访问的 URL。
字幕文件（可选）：支持 SRT 和 ASS 格式，需上传至可访问的 URL。如果不提供，部分接口可能支持自动识别生成（需确认具体服务说明）。
回调地址（可选）：用于接收任务完成通知的 URL。
📤 步骤一：提交视频加字幕任务
通过 POST 请求调用接口，提交视频处理任务。以下是核心参数说明：
必填参数
参数名 类型 说明
key string 接口密钥，从控制台获取
type string 固定值 start，表示提交任务
videoeditingurl string 视频文件的 URL 地址
可选参数（常用）
参数名 类型 默认值 说明
videotitle string - 视频标题，支持内联样式参数
subtitlefileurl string - 字幕文件 URL，支持 SRT/ASS 格式
subtitle_y int 自适应 字幕底部边距（像素）
subtitle_font_size int 10 字幕字号大小
subtitle_color string &HFFFFFF 字幕文字颜色（ASS 颜色代码）
subtitle_border_color string &H000000 字幕描边颜色
subtitle_outline int 1 字幕描边大小（0-4）
subtitle_shadow int 0 字幕阴影（0-3）
subtitle_alignment int 2 字幕对齐方式（1-9，2 为底部居中）
subtitle_font int 1 字幕字体编号
bgm string - 背景音乐 URL 或 bgm_id
bgm_volume string 0.3 背景音乐音量（0.0-1.0）
original_volume string 1.0 原视频音量（0.0-1.0）
callbackUrl string - 回调通知 URL
请求示例
{
"key": "35kj5jnlj53453kl5j43nj5",
"type": "start",
"videoeditingurl": "https://#/video.mp4",
"videotitle": "我的视频",
"subtitlefileurl": "https://#/subtitle.srt",
"subtitle_font_size": 12,
"subtitle_color": "&HFFFFFF",
"subtitle_alignment": 2,
"callbackUrl": "https://#/callback"
}
返回示例
{
"code": 200,
"msg": "提交成功",
"data": {
"taskId": "a9b86729-4691-425f-8b6d-e4a88c0e9c91"
}
}
⚠️ 请保存返回的 taskId，后续用于查询任务状态。
🔍 步骤二：查询任务状态
任务提交后，可以通过以下两种方式获取结果：
方式一：轮询查询
使用 taskId 主动查询任务状态。
请求参数
参数名 类型 说明
key string 接口密钥
type string 固定值 query
taskId string 提交任务时返回的任务 ID
请求示例
{
"key": "35kj5jnlj53453kl5j43nj5",
"type": "query",
"taskId": "a9b86729-4691-425f-8b6d-e4a88c0e9c91"
}
返回示例
{
"code": 200,
"msg": "查询成功",
"data": {
"taskId": "a9b86729-4691-425f-8b6d-e4a88c0e9c91",
"status": "SUCCESS",
"videoUrl": "https://#/output.mp4",
"duration": 60,
"subtitleFileUrl": "https://#/output.srt",
"md5": "78b35bb6b5f2b50e5438ed99fd7580d3"
}
}
方式二：回调通知
如果在提交任务时填写了 callbackUrl，任务完成后服务器会通过 POST 请求将结果发送到该地址。
回调数据格式与轮询返回的 data 字段结构一致。
📋 任务状态说明
状态值 说明
SUBMIT 已提交，等待处理
GENERATING 合成中
SUCCESS 合成成功
FAILED 合成失败
常见失败错误码
错误码 说明
21000 没有成功记录 ID
21001 模型 ID 不存在
21002 视频格式异常
21003 音频格式异常
21004 音频下载失败
21005 视频下载失败
21006 存在多人脸
💡 注意事项
视频要求：必须为有声视频，无声视频可能导致处理失败。
字幕格式：确保字幕文件为标准的 SRT 或 ASS 格式，时间轴需与视频匹配。
URL 可访问性：视频和字幕文件的 URL 必须公网可访问，否则会导致下载失败。
音量控制：bgm_volume 和 original_volume 建议保持默认值，过大的音量可能导致破音。
回调可靠性：使用回调方式时，建议在你的服务器端做好幂等处理，避免重复接收通知。
📌 总结
视频加字幕的完整流程为：
准备视频和字幕文件，获取可访问的 URL。
调用提交接口，传入必要参数，获取 taskId。
通过轮询或回调方式查询任务状态。
任务成功后，从返回结果中获取合成后的视频 URL。
按照以上步骤操作，即可高效完成视频字幕的合成与处理。
来源：酷虎云APi