generate_smart_subtitle

POST

/cut_jianying/generate_smart_subtitle

用于识别一段音频或者视频链接中的字幕，并按照指定的字幕模版样式添加回草稿中。这个接口是异步接口，返回task_id，然后利用这个task_id再去https://docs.vectcut.com/395278111e0 查看任务状态。注意，这里内置了添加文字的能力，所以识别结果会添加到草稿中，如果不需要将识别结果添加到草稿中请使用识别字幕https://docs.vectcut.com/442852943e0 功能。

使用说明

agent_id，字幕模版。

draft_id, 基于已有草稿编辑，为空表示创建新草稿

url, 视频或者音频链接

add_media, 是否添加视频或者音频到草稿里，默认True

text_content, 正确字幕，用来校对识别结果，推荐小语种、方言必填

返回说明

task_id, 任务id，利用这个task_id去https://docs.vectcut.com/395278111e0 查看任务状态

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location 'https://open.vectcut.com/cut_jianying/generate_smart_subtitle' \
--header 'Authorization: Bearer  <token>' \
--header 'Content-Type: application/json' \
--data '{
    "agent_id": "asr_42da310c1e4347ddb2c96dd2a5d055c2",
    "url": "https://player.install-ai-guider.top/example/digital_human.mp4"
}'

响应示例

成功示例

{
    "task_id": "924E4C927BEE000216140F22DDDA345F"
}

修改于 2026-07-19 06:56:26

如何使用字幕模版

smart_subtitle_task_status

generate_smart_subtitle

使用说明#

返回说明#

请求参数

返回响应

使用说明

返回说明