POST /api/dev/tasks
创建翻译任务。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
title | string | 是 | 任务标题 |
videoPath | string | 是 | 视频文件路径。支持本地绝对路径或 HTTP(S) URL |
sourceLanguage | string | 是 | 源语言代码 |
targetLanguage | string | 是 | 目标语言代码 |
translationStyle | string | 否 | 翻译风格:standard(默认)、casual、professional、literary |
startTime | number | 否 | 视频截取起始时间(秒),默认 0 |
endTime | number | 否 | 视频截取结束时间(秒),默认 0(到结尾) |
removeSubtitles | boolean | 否 | 是否启用字幕抹除(Step 3),默认 true |
denoiseBackground | boolean | 否 | 是否对背景音去噪(Step 2b 后,对 background.wav 去除环境噪声、保留背景音乐),默认 false |
addSubtitles | boolean | 否 | 是否添加翻译字幕(Step 8),默认 true |
subtitleMode | string | 否 | 字幕模式:hard(硬字幕,烧入视频)或 soft(软字幕),默认 hard |
subtitleTemplateId | number | 否 | 字幕模板 ID(仅硬字幕模式生效)。-1 表示系统默认,不传则使用字幕管理中默认模板 |
progressbarTemplateId | number | 否 | 进度条模板 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— 积分不足。