POST /api/dev/tasks

创建翻译任务。

参数类型必填说明
titlestring任务标题
videoPathstring视频文件路径。支持本地绝对路径或 HTTP(S) URL
sourceLanguagestring源语言代码
targetLanguagestring目标语言代码
translationStylestring翻译风格:standard(默认)、casualprofessionalliterary
startTimenumber视频截取起始时间(秒),默认 0
endTimenumber视频截取结束时间(秒),默认 0(到结尾)
removeSubtitlesboolean是否启用字幕抹除(Step 3),默认 true
denoiseBackgroundboolean是否对背景音去噪(Step 2b 后,对 background.wav 去除环境噪声、保留背景音乐),默认 false
addSubtitlesboolean是否添加翻译字幕(Step 8),默认 true
subtitleModestring字幕模式:hard(硬字幕,烧入视频)或 soft(软字幕),默认 hard
subtitleTemplateIdnumber字幕模板 ID(仅硬字幕模式生效)。-1 表示系统默认,不传则使用字幕管理中默认模板
progressbarTemplateIdnumber进度条模板 ID。-1 表示系统默认"鸭鸭进度条",不传则不添加进度条。进度条在视频底部叠加动态进度,降低视频指纹相似度

请求示例:

curl -X POST http://127.0.0.1:9527/api/dev/tasks \
  -H "Content-Type: application/json" \
  -H "X-API-Key: dk_your_key_here" \
  -d '{
    "title": "视频翻译",
    "videoPath": "/Users/test/demo.mp4",
    "sourceLanguage": "en",
    "targetLanguage": "zh",
    "translationStyle": "standard"
  }'

响应示例:

{
  "ok": true,
  "data": {
    "taskId": "task_1745398800000_a1b2c3",
    "status": "running",
    "estimatedPoints": 0
  }
}

错误码400 — 参数不完整或 videoPath 格式无效;401 — 无效的 API Key;402 — 积分不足。