POST /api/dev/subtitle-management

提交视频烧录字幕任务。需要先在客户端创建字幕模板(或使用 -1 表示系统默认),获取 templateId 后调用。

参数类型必填说明
inputPathstring视频文件本地绝对路径
srtPathstringSRT 字幕文件本地绝对路径
templateIdnumber字幕模板 ID(在客户端字幕管理 → 模板管理中创建),-1 表示系统默认
outputPathstring输出路径,默认存草稿目录
crfnumber视频质量 CRF 值(0-51),默认 21
presetstring编码速度:ultrafast / fast / medium / slow,默认 fast

请求示例:

curl -X POST http://127.0.0.1:9527/api/dev/subtitle-management \
  -H "X-API-Key: dk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"inputPath": "/Users/test/demo.mp4", "srtPath": "/Users/test/demo.srt", "templateId": 3}'

响应示例:

{
  "ok": true,
  "data": {
    "taskId": "sub_1717200000000_abc123",
    "status": "running",
    "templateName": "我的字幕模板"
  }
}

字幕模板字段

字幕模板决定 ASS Style 行的样式,包含:

  • fontFamily — 字体(PingFang SC、微软雅黑、Arial、Times New Roman)
  • fontSize — 主字幕字号(推荐 40-80)
  • fontSizeSecondary — 副字幕字号(双语字幕第二行)
  • fontColor — 字体颜色(HEX)
  • bold — 是否加粗
  • spacing — 字间距(像素)
  • marginV — 距视频底边的边距(1080p 下像素值)

SRT 格式说明

支持标准 SRT(UTF-8 编码,含 BOM 也兼容)。每条字幕的多行文本按顺序渲染:

  • 第 1 行用主字号
  • 第 2 行及之后用副字号(通过 ASS inline override {\fs副} 覆盖)

HTML 标签(如 <b>)会被自动剥离。