get_duration

POST /get_duration

接口说明

用 ffprobe 读取远程视频或音频的真实时长，单位为秒。添加视频、音频前建议先调用它，再把结果传给 duration 和 end，避免草稿时长变成 0。

请求参数

参数	必填	默认值	说明
url	是	—	视频或音频的远程地址；与 video_url 二选一
video_url	是	—	url 的别名；与 url 二选一

服务端使用 ffprobe 探测真实时长，最多重试 3 次，每次超时 10 秒。时间单位为秒。

调用示例

curl -X POST https://your-domain.example/api/get_duration \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $VECTCUT_API_KEY" \
  -d '{"url":"https://example.com/clip.mp4"}'

返回格式

{
  "success": true,
  "output": {
    "duration": 12.345,
    "format": "mp4"
  },
  "error": ""
}

添加视频或音频时，用返回的 output.duration 设置 end 和 duration，避免草稿时间轴出现 0 秒或错误时长。