智能字幕

对视频进行语音识别，自动生成字幕，支持翻译为其他语言，并提供多种字幕样式和颜色选择。可选择将字幕渲染烧录到视频中。

创建任务

基本信息

项目	值
请求方法	POST
请求路径	/task/video_ai_subtitle
Content-Type	application/json
鉴权方式	Authorization 请求头（直接传 API Key）

请求参数（Body）

参数名	类型	必填	默认值	说明
file_id	string	是	—	已上传视频文件的 ID
language	string	是	—	字幕源语言代码，完整列表见下方“支持的语言代码”
translate_language	string	否	—	字幕翻译目标语言代码，支持范围与 language 相同；不填则不翻译
need_render	boolean	否	false	是否将字幕烧录到视频中
need_pure	boolean	否	false	是否先去除原视频中已有的字幕
lingual_type	string	否	"bilingual"	字幕语言类型：monolingual（单语）/ bilingual（双语，需设置翻译语言），示例见下方“字幕样式示例”
subtitle_type	string	否	"default"	字幕样式：default / outline / cinema_yellow / immersive_box / wide_spacing / deep_shadow / boxed，示例见下方“字幕样式示例”
subtitle_color	string	否	"雅黑"	字幕颜色：雅黑 / 淡绿 / 森林绿 / 湖蓝 / 道奇蓝 / 钢蓝 / 浅粉红 / 深橙 / 珊瑚橙 / 橙红 / 土豪金

支持的语言代码

language 与 translate_language 使用同一组语言代码，智能字幕支持以下 11 种语言互译：

语言代码	语言名称
zh-CHT	中文繁体
zh-CHS	中文简体
zh-CN	中文
ja-JP	日文
en-US	英文
es-ES	西班牙文
ru-RU	俄文
ko-KR	韩文
fr-FR	法文
pt-PT	葡萄牙文
vi-VN	越南文

提示：当 lingual_type 为 bilingual 时，建议显式传入 translate_language，并确保它也来自上表。

字幕样式示例

以下展示智能字幕当前支持的全部 7 种 subtitle_type 样式，并覆盖：

• monolingual 与 bilingual
• 1080x1920、1920x1080、2160x3840、3840x2160、480x848、848x480

请求中请直接使用对应的 subtitle_type 参数值。

content 对象（可选）

可通过 content 字段补充视频上下文信息，帮助提升字幕准确率：

参数名	类型	说明
content.video_title	string	视频标题
content.video_info	string	视频内容摘要描述

请求示例

curl -X POST https://api.ai-mcn.tv:10000/task/video_ai_subtitle \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_id": "537489015178246",
    "language": "zh-CN",
    "translate_language": "en-US",
    "need_render": true,
    "lingual_type": "bilingual",
    "subtitle_type": "outline",
    "subtitle_color": "雅黑"
  }'

成功响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178247",
    "task_type": "video_ai_subtitle",
    "status": "queued"
  }
}

---

查询任务结果

基本信息

项目	值
请求方法	GET
请求路径	/task/video_ai_subtitle/{task_id}
鉴权方式	Authorization 请求头（直接传 API Key）

响应参数（output_result）

参数名	类型	说明
file_id	string	烧录字幕后的视频文件 ID（仅 need_render: true 时返回）
subtitle_file_id	string	字幕文件 ID（SRT 格式）

成功响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178247",
    "status": "completed",
    "progress": 100,
    "output_result": {
      "file_id": "537489015178248",
      "subtitle_file_id": "537489015178249"
    },
    "create_time": "2026-04-05T08:00:00Z",
    "update_time": "2026-04-05T08:01:30Z"
  }
}

错误码

错误码	HTTP 状态码	说明	解决方案
6013	400	file_id 或 language 缺失	补充必填参数
6015	400	不支持的语言代码	使用上表中的受支持语言代码
6004	404	文件不存在	检查 file_id 是否正确
6502	401	鉴权失败	检查 Authorization 请求头
6202	402	余额不足	前往仪表盘充值