视频智能分镜

基于多模态大模型的视频语义理解能力，从场景、镜头类型、叙事结构或主体视角对视频进行智能分镜，并输出结构化分类结果。默认仅返回结构化数据；如需同时导出切片文件，可将 only_struct 设为 false。

处理示例

创建任务

基本信息

请求参数

模式说明

请求示例

curl -X POST https://api.ai-mcn.tv:10000/task/video_ai_segment \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_id": "537489015178246",
    "mode": "scene",
    "min_duration": 1.5,
    "max_duration": 120,
    "only_struct": true
  }'

成功响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178247",
    "task_type": "video_ai_segment",
    "status": "queued"
  }
}

查询任务结果

基本信息

响应参数

shots 字段说明

files 字段说明

[
  {
    "id": 1,
    "file_id": "56817731376500742",
    "download_url": "https://api.ai-mcn.tv:9000/cloud/file/a6/56817731376500742.mp4"
  }
]

成功响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178247",
    "status": "completed",
    "progress": 100,
    "output_result": {
      "mode": "scene",
      "total_shots": 2,
      "total_duration": 18.6,
      "categories": [
        {
          "category": "人物讲述",
          "category_desc": "人物正面对镜表达观点",
          "shots": [
            {
              "id": 1,
              "subjects": ["讲述者", "室内背景"],
              "tags": ["口播", "正面镜头"],
              "shot_type": "中景",
              "desc": "人物在室内讲述内容",
              "start_time": 0.0,
              "end_time": 8.2,
              "confidence": 0.96,
              "thumbnail_time": 4.1,
              "category": "人物讲述",
              "category_desc": "人物正面对镜表达观点"
            }
          ]
        }
      ],
      "files": [
        {
          "id": 1,
          "file_id": "56817731376500742",
          "download_url": "https://api.ai-mcn.tv:9000/cloud/file/a6/56817731376500742.mp4"
        }
      ]
    },
    "create_time": "2026-04-09T08:00:00Z",
    "update_time": "2026-04-09T08:02:10Z"
  }
}

错误码

使用限制

• 当前接口仅支持单个视频文件
• 长视频会被自动切成多个重叠片段进行分析，再在服务端合并结果
• 默认只返回结构化结果；如需导出切片文件，请设置 only_struct=false