POST /api/dev/watermark

提交视频添加水印任务。需要先在客户端创建水印模板,获取 templateId 后调用。

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

请求示例:

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

响应示例:

{
  "ok": true,
  "data": {
    "taskId": "wm_1717200000000_abc123",
    "status": "running",
    "templateName": "我的水印"
  }
}