提交异步抠像任务

POST

/process/remove_bg/submit_task/submit_remove_bg_task

抠人像功能。典型用途：

只拿抠像结果（mask / inverted_mask）去做你自己的后处理。

自动写草稿轨道，快速完成抠像合成。

通过 compose_draft 控制行为：

compose_draft=true：执行完整草稿编排（add_video + add_preset）。

compose_draft=false：仅返回抠像结果，不写草稿。

返回 task_id 后请调用 task_status 轮询，直到 status=success。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

示例

返回响应

🟢200

application/json

提交成功

Body

🟠400

请求示例

Shell

JavaScript

Java

Swift

cURL

remove_bgremove_bg + draft

curl --location --request POST 'https://open.vectcut.com/process/remove_bg/submit_task/submit_remove_bg_task' \
--header 'Authorization: Bearer  <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "video_url": "https://player.install-ai-guider.top/example/koubo_source.mp4",
    "compose_draft": false
}'

响应示例

200 - 成功示例

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

修改于 2026-04-15 02:03:00

提交异步抠像画中画任务

查询任务状态（GET）