长剪短（精剪）

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

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

定位为精剪 / 走量出片：只输出渲染好的成片 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`	否	—	预转写结果（须含字级时间戳 `word_tc_list`），提供则跳过内部识别；不接受人工文稿
`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`	源片自带烧录字幕时先去除，避免与新字幕重影；无字幕生素材保持关闭

支持语种：中文 zh-CN、简体 zh-CHS、繁体 zh-CHT、英文 en-US、日文 ja-JP、韩文 ko-KR、法文 fr-FR、西班牙文 es-ES、葡萄牙文 pt-PT、俄文 ru-RU、越南文 vi-VN。

请求示例

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`	选段报告（单元数 / 条数 / 是否跳剪等）
`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.purify_source。
按输入时长计费：以输入视频时长（分钟）计费，与输出条数无关。
核心产物保障：选段 / 跳剪产不出时任务才失败（自动退款）；运镜 / 调速 / 接缝 / 分屏 / 字幕为可降级润色，单项失败记录在 errors，不影响成片产出。