POST /api/dev/video-processing
提交视频加工任务。支持转码、裁切、调整分辨率、码率等操作。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
inputPath | string | 是 | 视频文件本地绝对路径 |
outputPath | string | 否 | 输出路径,默认草稿目录 |
codec | string | 否 | 编码格式:h264、h265、av1,默认 h264 |
bitrate | string | 否 | 码率,如 5M、2000k |
resolution | string | 否 | 分辨率,如 1920x1080 |
crop | string | 否 | 裁切比例 9:16、3:4、1:1、4:5 或 w:h |
cropOffsetX | number | 否 | 裁切区域水平偏移(像素),默认居中 |
cropOffsetY | number | 否 | 裁切区域垂直偏移(像素),默认居中 |
startTime | number | 否 | 截取起始时间(秒) |
endTime | number | 否 | 截取结束时间(秒) |
请求示例:
curl -X POST http://127.0.0.1:9527/api/dev/video-processing \
-H "X-API-Key: dk_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"inputPath": "/Users/test/demo.mp4",
"codec": "h265",
"bitrate": "5M",
"crop": "9:16"
}'
响应示例:
{
"ok": true,
"data": {
"taskId": "vp_1714700000000_abc1",
"status": "running",
"config": {
"inputPath": "/Users/test/demo.mp4",
"outputPath": "",
"codec": "h265",
"bitrate": "5M",
"crop": "9:16"
}
}
}