提交音频提取任务（异步）

POST

/process/extract_audio/submit_task/submit_extract_audio_task

这个接口能帮你做什么

把视频中的人声、对白、旁白或背景音快速提取成独立音频，便于后续剪辑、转写和二次制作。

常见剪辑场景

先抽音频再做字幕：将视频音轨单独导出，提升语音识别与字幕生成速度

人声与画面分离：做 B-roll、混剪或节奏重组时，先保留原声素材再重新配画面

背景音二次利用：提取环境音/氛围音，复用到片头片尾或其他短视频

配音前置处理：先拿到干净音轨，便于降噪、音量均衡和后续配音替换

使用方式

第一步：调用提交接口创建任务，拿到 task_id

第二步：通过 task_status 轮询任务进度与结果

第三步：任务成功后获取音频地址（public_url）

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

示例

返回响应

🟢200

application/json

提交成功，任务已入队

Body

🟠400

🔴500

请求示例

Shell

JavaScript

Java

Swift

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

响应示例

200 - 成功示例

{
    "message_id": "1A1F8E087BEE7F95162E46BBA9D7FBD8",
    "queue_name": "extract-audio-task",
    "status": "queued",
    "success": true,
    "task_id": "af9de4fa-a51a-4d8f-8c17-df159bb48542"
}

修改于 2026-04-14 10:03:38

get_duration

查询任务状态（GET）

提交音频提取任务（异步）

这个接口能帮你做什么#

常见剪辑场景#

使用方式#

请求参数

返回响应

这个接口能帮你做什么

常见剪辑场景

使用方式