长剪短（精剪）

长剪短（精剪）（长视频转高光短视频·精剪）把一条长内容（播客 / 圆桌 / 脱口秀 / 访谈 / 直播回放）一键拆成多条不同主题的高光成品短片，直接出片、无需再进剪辑软件。与粗剪共享「按语义选段 + 跳剪 + 字级精确切点」内核，并在其上叠加成片级润色：

画布模糊背景填充：输入横屏竖屏均可，横竖互转时用模糊背景填充补足画幅，观感高级，无黑边；
克制运镜：对部分片段做缓慢的推近 / 拉远（亚像素平滑、随机且可复现、有频率上限），避免呆板，又不喧宾夺主；
整体调速：可对成片整体加速，保持音高不变声，提升节奏与留存；
智能字幕：自动生成并烧录字幕（去标点、按语义切成屏宽短句），可选译文双语；源片自带烧录字幕时可先行去除；
可选分屏：多人同框段合成竖版多格分屏（说话人在上 / 面对面、白色边框）。

定位为精剪 / 走量出片：只输出渲染好的成片 mp4（每条高光一条），不出剪辑时间线 / 工程文件——需要导入剪辑软件继续精修请用粗剪。

示例效果

三条真实长视频的输入 / 输出对照：第一列是投进去的长片，右侧是同一次任务产出的高光。每组的两行分别是按 9:16 与 16:9 各跑一次的结果；出几条、每条多长完全由内容决定，因此不同任务的分条可能略有差异。

示例一 · 直播回放（竖屏源）

源片 720×1280 竖屏，全长 3 小时 25 分。9:16 为源片原生画幅；16:9 由左右模糊背景填充补足画幅，不留黑边。

输入原片	高光 1	高光 2	高光 3
全长 3 小时 25 分	9:16 · 41 秒	9:16 · 2 分 29 秒	9:16 · 1 分 31 秒
（同一源片）	16:9 · 41 秒	16:9 · 2 分 29 秒	16:9 · 1 分 31 秒

示例二 · 双人访谈（横屏源）

源片 1280×720 横屏，全长 26 分钟。16:9 为源片原生画幅；9:16 上下以模糊背景填充，且多人同框段自动合成分屏（白色边框）。

输入原片	高光 1	高光 2	高光 3
全长 26 分钟	9:16 · 45 秒	9:16 · 36 秒	9:16 · 10 秒
（同一源片）	16:9 · 45 秒	16:9 · 31 秒	16:9 · 21 秒

示例三 · 双人对谈（横屏源 · 4K 实拍）

源片 1920×1080 横屏，全长 15 分 36 秒。16:9 为源片原生画幅；9:16 上下以模糊背景填充。这一组还可直接对照 split_screen 的开关差异：9:16 一行的分屏是横屏源转竖屏时的固有行为、无需开启；16:9 一行的高光 1、2 开启了 split_screen，高光 3 未开。

输入原片	高光 1	高光 2	高光 3
全长 15 分 36 秒	9:16 · 3 分 13 秒	9:16 · 1 分 52 秒	9:16 · 1 分 21 秒
（同一源片）	16:9 · 4 分 31 秒（分屏）	16:9 · 1 分 52 秒（分屏）	16:9 · 1 分 4 秒（未开分屏）

以上示例均为 720p WebM 预览版，实际产物为原分辨率 mp4。

创建任务

基本信息

项目	值
请求方法	`POST`
请求路径	`/task/video_long2short_pro`
Content-Type	`application/json`
鉴权方式	`Authorization` 请求头（直接传 API Key）
计费	按输入视频时长（分钟）计费

请求参数（Body）

参数名	类型	必填	默认值	说明
`file_id`	`string`	是	—	长视频文件 ID（先经文件上传获取）
`language`	`string`	是	—	内容语种，见下方支持列表；不在列表内返回不支持语种错误
`output_language`	`string`	否	跟随 `language`	标题 / 简介等元数据的输出语种（取值同 `language`）
`stt`	`object`	否	—	预转写结果，结构见长视频转高光短视频的「stt 对象」（须同时含字级 `word_tc_list` 与句级 `sentence_tc_list`，缺一会无法成句、选段为空）；提供则跳过内部识别；不接受人工文稿；与 `subtitle_file_id` 互斥
`subtitle_file_id`	`string`	否	—	已上传的单语字幕文件 ID（`.srt` / `.ass`），作为转写来源、跳过内部识别；与 `stt` 互斥。切点精度为字幕行边界（仍帧对齐），烧录字幕的句文本即字幕行；多层 / 双语 `.ass` 会在执行期被拒（任务失败并退款）
`main_topic`	`string`	否	—	视频主话题，作为选段软提示
`output_size`	`string`	否	`9:16`	成片画布：`9:16` / `16:9` / `1:1`，或自定义如 `1080x1920`。输入横竖均可，自动以模糊背景填充适配
`jump_cut`	`boolean`	否	`true`	跳剪（话题内语义压缩）。关闭则每条为连续片段
`duration`	`object`	否	`{}`	时长控制：`pref`（`auto`/`short`/`medium`/`long` 软提示）、`max_clip_sec`（单条上限秒，5~1800）。纯语义、无强制时长
`split_screen`	`object`	否	`{enable:false}`	分屏增强：`enable`、`orientation`（`auto` 随机 / `lr` 左右 / `tb` 上下）。仅多人同框段合成多格
`camera_move`	`object`	否	`{enable:true}`	运镜（见下表）
`speed`	`object`	否	`{factor:1.0}`	整体调速：`factor`（0.5~2.0），保音高
`seam`	`object`	否	`{crossfade_ms:30}`	接缝处理：`crossfade_ms`（0~500），音频交叉淡入淡出磨顺硬切
`subtitle`	`object`	否	`{enable:true}`	字幕（见下表）

camera_move 对象

字段	类型	默认值	说明
`enable`	`boolean`	`true`	是否启用运镜
`probability`	`number`	`0.35`	单段触发概率（0~1）
`amplitude`	`number`	`0.08`	推/拉幅度（0~0.5），越大越明显
`max_ratio`	`number`	`0.5`	运镜段占比上限（0~1），控制不过于频繁
`blur_sigma`	`number`	`40`	背景虚化强度（0~100），越大越糊

subtitle 对象

字段	类型	默认值	说明
`enable`	`boolean`	`true`	是否烧录字幕
`translate_language`	`string`	—	译文语种（取值同 `language`），提供则出原文 + 译文双语；缺省单语
`purify_source`	`boolean`	`false`	源片自带烧录字幕时先去除，避免与新字幕重影；无字幕生素材保持关闭
`strip_punctuation`	`boolean`	`true`	烧录字幕的标点口径。`true`（默认）按统一口径去标点：中英逗号句号替换为空格、词内小数 / 千分位豁免、`？！` 等其余标点保留；`false` 完整保留全部标点

识别源语种（language）：中文 zh-CN、简体 zh-CHS、繁体 zh-CHT、英文 en-US、日文 ja-JP、韩文 ko-KR、法文 fr-FR，共 7 种。

es-ES（西班牙文）、pt-PT（葡萄牙文）、ru-RU（俄文）、vi-VN（越南文）不可作本能力的识别源语种：本能力的产物依赖字级时间戳，而这四个码在本能力的识别引擎上拿不到字级时码（前两者更是没有对应引擎）。传入会在建单时同步返回错误码 6015，不计费、不排队。其中 es-ES / pt-PT 可用于字幕翻译目标语（见「智能字幕」与「字幕翻译」）。

元数据输出语种（output_language）：仍取上述 11 个代码的全集，不受识别引擎能力限制。本能力的 tl（字幕翻译目标语）同样取 11 个代码的全集，不受本条收窄影响。

请求示例

curl -X POST https://api.ai-mcn.tv:10000/task/video_long2short_pro \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_id": "81005495682916358",
    "language": "zh-CN",
    "output_size": "9:16",
    "camera_move": {"enable": true, "amplitude": 0.08},
    "speed": {"factor": 1.15},
    "subtitle": {"enable": true, "purify_source": true},
    "split_screen": {"enable": true}
  }'

成功响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178401",
    "task_type": "video_long2short_pro",
    "status": "queued"
  }
}

查询任务结果

基本信息

项目	值
请求方法	`GET`
请求路径	`/task/video_long2short_pro/{task_id}`
鉴权方式	`Authorization` 请求头（直接传 API Key）

响应参数（output_result）

参数名	类型	说明
`clips`	`array`	多条高光成品，每条含发布元数据 + 成片文件（详见下文）
`report`	`object`	选段报告（单元数 / 条数 / 是否跳剪等）+ 降级口径：`degraded`（布尔，选段降级或任一润色项降级，与 `errors` 非空等价）、`degraded_items`（如 `{"clip1": ["split_screen"]}`，列明哪条 clip 的哪些润色项降级；无降级为 `{}`）
`errors`	`object`	润色项（运镜 / 调速 / 接缝 / 分屏 / 字幕）局部失败原因，不影响核心成片

clips[] 元素

字段	类型	说明
`title` / `summary` / `tags`	`string` / `string` / `array`	标题、简介、标签（适合直接发布）
`score` / `score_reason`	`number` / `string`	传播潜力评分（0~10）与理由
`highlight_words`	`array`	高光词及其字级时间 `{text, begin_time, end_time}`
`genres` / `moods` / `themes`	`array`	配乐风格 / 情绪 / 主题关键词
`file`	`object`	该高光的成片：`{type:"video", format:"mp4", file_id, download_url, filename}`

错误码

错误码	HTTP 状态码	说明	解决方案
`6013`	400	`file_id` / `language` 缺失	补充必填参数
`6004`	404	文件不存在	检查 `file_id` 是否正确
`6014`	400	文件类型与任务不匹配（需视频文件）	上传视频格式文件
`6016`	400	业务参数非法（`camera_move` / `speed` / `seam` / `subtitle` / `output_size` / `duration` 越界，或误传 `outputs` / `source_path`）	按响应提示修正参数
`6017`	400	不支持的语种	使用支持语种列表中的取值
`6502`	401	鉴权失败	检查 `Authorization` 请求头
`6201`	402	配额不足	购买配额包或充值
`6202`	402	余额不足	前往仪表盘充值

使用限制

精剪定位：本能力一键出成品，只产成片 mp4；不接受 outputs / source_path（需工程文件请用粗剪）。
按语义、不卡时长：出几条、每条多长完全由内容决定；duration 仅软提示与单条安全上限。
运镜克制：推/拉镜头按概率与频率上限随机触发、幅度有限、可复现，避免廉价自动剪辑感。
调速保音高：整体加速不变声；factor 取值 0.5~2.0。
字幕：默认按统一口径去标点（逗号句号换空格、？！ 等保留，可用 subtitle.strip_punctuation:false 完整保留）并按语义切短句；源片自带烧录字幕时建议开启 subtitle.purify_source。
按输入时长计费：以输入视频时长（分钟）计费，与输出条数无关。
核心产物保障：选段 / 跳剪产不出时任务才失败（自动退款）；运镜 / 调速 / 接缝 / 分屏 / 字幕为可降级润色，单项失败记录在 errors，不影响成片产出。是否发生过降级看 report.degraded，降了哪些看 report.degraded_items，无需自行解析 errors。