智能高光剪辑

顺剪（CONTINUOUS）

顺剪从开场钩子出发，沿原剧情持续向后推进，仅跳过由模型标记且通过镜头边界校验的包装范围，保留原始叙事顺序。该模式适用于将整集内容压缩为节奏更紧凑的连续版本。

使用顺剪时，per_media_target_duration必须为null、require_all_media必须为false。

混剪（STORY_CUT）

混剪在多个来源视频之间进行跨片段选材与拼接，media_index保持非递减、同一来源视频内时间保持非递减。该模式适用于将多集素材重组为高信息密度的高光合集。

混剪支持通过per_media_target_duration控制每个视频的软目标贡献时长，并可通过require_all_media要求每条成片覆盖全部输入。

提交高光剪辑任务

• 请求方法：POST

• 请求路径：/api/v1/operators/highlight-editing/tasks

• 生成顺剪CONTINUOUS或混剪STORY_CUT成片。两种模式均由大模型规划，服务端校验时间线并使用FFmpeg导出。

请求参数

调用示例

{
  "media_inputs": [
    {"uri": "https://media.example.com/episode-01.mp4"},
    {"uri": "https://media.example.com/episode-02.mp4"}
  ],
  "highlight_description": "优先选择视觉冲击强、人物张力明显的剧情",
  "editing": {
    "mode": "STORY_CUT",
    "output_count": 2,
    "target_duration": 120,
    "per_media_target_duration": 60,
    "require_all_media": false,
    "opening_hook": {
      "description": "优先选择动作正在升级的瞬间",
      "target_duration": 10
    }
  },
  "output": {
    "need_export": true,
    "oss": {
      "region": "cn-shanghai",
      "bucket": "customer-bucket",
      "object_key": "highlight-edits/{task_id}/output_{index}.mp4"
    }
  }
}

响应示例

{
  "status": "SUCCESS",
  "message": null,
  "data": {"task_id": "1720000000000_efgh", "task_status": "PENDING"}
}

其中，status为API调用状态，默认SUCCESS；message为错误信息，成功时为null；data.task_id为任务ID；data.task_status为异步任务状态，默认PENDING。

cURL 示例

curl -X POST 'http://{endpoint}/api/v1/operators/highlight-editing/tasks' \
  -H 'Content-Type: application/json' \
  -d '{
    "media_inputs": [{"uri": "https://media.example.com/episode-01.mp4"}],
    "editing": {
      "mode": "CONTINUOUS",
      "output_count": 1,
      "target_duration": 120,
      "opening_hook": {"target_duration": 10}
    },
    "output": {"need_export": false}
  }'

HTTP状态码

查询高光剪辑任务

• 请求方法：GET

• 请求路径：/api/v1/operators/highlight-editing/tasks/{task_id}

• 查询顺剪或混剪任务状态、开场钩子、来源时间线和完整成片地址。查询失败任务时HTTP仍返回200，并在data.error中返回异步错误。

请求参数

响应参数

响应示例

{
  "status": "SUCCESS",
  "message": null,
  "data": {
    "task_id": "1720000000000_efgh",
    "task_status": "SUCCESS",
    "mode": "STORY_CUT",
    "need_export": true,
    "outputs": [{
      "index": 0,
      "duration": 118.6,
      "opening_hook": {"media_index": 0, "start_time": 125.4, "end_time": 135.4},
      "media_results": [
        {"media_index": 0, "start_time": 125.4, "end_time": 135.4, "playback_speed": 1.0},
        {"media_index": 0, "start_time": 151.0, "end_time": 200.3, "playback_speed": 1.0},
        {"media_index": 1, "start_time": 42.1, "end_time": 101.4, "playback_speed": 1.0}
      ],
      "output_url": "https://download.example.com/output-0.mp4"
    }],
    "error": null
  }
}

cURL 示例

curl 'http://{endpoint}/api/v1/operators/highlight-editing/tasks/1720000000000_efgh'

HTTP状态码