提交按时间区间分割视频任务

POST

/process/split_video/submit_task/submit_split_video_task

适用场景

从一个长视频里，快速截出你真正要用的片段

适合做短视频切片，口播重点内容截取，特殊处理片段截取

不需要你手动下载和本地剪辑，直接返回可访问的片段地址

提交后立即返回 task_id，适合服务端批量并发

输入

video_url：待切割视频 URL

start：开始时间（支持秒数或 HH:MM:SS(.ms)）

end：结束时间（支持秒数或 HH:MM:SS(.ms)，且大于 start）

成功入队：返回 task_id 与 status=queued

后续请调用 task_status 轮询直至 success/failed

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

返回响应

🟢200

application/json

提交成功

Body

🟠400

请求示例

Shell

JavaScript

Java

Swift

cURL

按hh:mm:ss(.ms)切割按秒切割

curl --location --request POST 'https://open.vectcut.com/process/split_video/submit_task/submit_split_video_task' \
--header 'Authorization: Bearer  <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "video_url": "https://player.install-ai-guider.top/example/koubo_source.mp4",
    "start": "00:00:03.200",
    "end": "00:00:05.100"
}'

响应示例

200 - 成功示例

{
    "success": true,
    "task_id": "09abc927-2703-44b5-9bf4-fc4837978a6c",
    "message_id": "534069327BEE0001160645173CAC96A5",
    "status": "queued",
    "queue_name": "split-video-task"
}

修改于 2026-04-16 07:29:59

查询任务状态（GET）

提交按时间区间分割视频任务

适用场景#

输入#

返回#

请求参数

返回响应

适用场景

输入

返回