POST /api/dev/subtitle-management
提交视频烧录字幕任务。需要先在客户端创建字幕模板(或使用 -1 表示系统默认),获取 templateId 后调用。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
inputPath | string | 是 | 视频文件本地绝对路径 |
srtPath | string | 是 | SRT 字幕文件本地绝对路径 |
templateId | number | 是 | 字幕模板 ID(在客户端字幕管理 → 模板管理中创建),-1 表示系统默认 |
outputPath | string | 否 | 输出路径,默认存草稿目录 |
crf | number | 否 | 视频质量 CRF 值(0-51),默认 21 |
preset | string | 否 | 编码速度: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>)会被自动剥离。