POST /api/dev/progressbar
提交视频添加进度条任务。在视频底部叠加动态进度条,随播放进度增长并带动头部图标(支持 GIF 动画)移动,用于降低视频指纹相似度。templateId 传 -1 表示使用系统默认"鸭鸭进度条"。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
inputPath | string | 是 | 视频文件本地绝对路径 |
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/progressbar \
-H "X-API-Key: dk_your_key_here" \
-H "Content-Type: application/json" \
-d '{"inputPath": "/Users/test/demo.mp4", "templateId": -1}'
响应示例:
{
"ok": true,
"data": {
"taskId": "pb_1717200000000_abc123",
"status": "running",
"templateName": "鸭鸭进度条"
}
}