视频分镜算子,基于多模态大模型对输入视频进行镜头/场景切分、全局角色识别、场景级人物关联以及人物图片抽取。算子会输出场景汇总结果、人物注册表、每个场景的切片视频,以及按人物归档的图片文件,便于后续检索、剪辑和内容理解。
算子 ID:las_video_scene_seg
min_segment_duration == max_segment_duration 时的等时长切分。以上为部分产出物的示意结果。
细分项 | 性能影响说明 |
|---|---|
耗时 |
|
细分 | 详细要求 |
|---|---|
支持的输入数据模态 |
|
输入格式:视频 |
|
输入路径要求 | 通过请求参数
|
细分 | 详细要求 |
|---|---|
输出数据模态 |
|
输出路径:TOS | 通过请求参数
|
计费标准
细分项 | 计费标准说明 |
|---|---|
计费项 | 基于输入视频的时长统计用量进行计费。 |
计费类型 | 按量计费,单位: |
单价 | 1.5 元/分钟 |
计费详情
计费公式:总费用 = 单价 * 用量
细分项 | 注意与前提 |
|---|---|
开通 LAS |
|
费用 | 调用算子前,您需先了解使用算子时的模型调用费用,详情请参见大模型调用计费。 |
鉴权(API Key) | 调用算子前,您需要先生成算子调用的API Key,并建议将API Key配置为环境变量,便于更安全地调用算子,详情请参见获取 API Key 并配置。 |
BaseURL | 调用算子前,您需要先根据您当前使用的LAS服务所在地域,了解算子调用的BaseURL,用于配置算子调用路径参数取值。 |
调用视频分镜算子提交异步任务,支持场景切分、人物提取、场景切片和结果上传。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
operator_id | string | 是 | las_video_scene_seg | 算子 ID |
operator_version | string | 是 | v1 | 算子版本 |
data | VideoSceneSegUserReqParams | 是 | 视频场景切分与人物定位请求参数 | |
video_url | string/array | 是 | https://example/sample_video.mp4 | 输入视频地址。支持 http/https、tos://bucket/key。 |
output_tos_path | string | 是 | tos://bucket/output/ | 输出根目录。算子会在该目录下自动追加任务相关子目录,上传 JSON、场景视频和人物图片。 |
min_segment_duration | float | 否 | 4.0 | 单个场景最小时长(秒),默认 4.0,范围 1.0 ~ 100.0。 |
max_segment_duration | float | 否 | 10.0 | 单个场景最大时长(秒),默认 10.0,范围 1.0 ~ 100.0。 |
seg_mode | string | 否 | precise | 场景切分模式。可选值: precise、rough。 |
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
metadata | metadata | 请求元信息 | |
task_id | string | task-xxx | 异步模式下的任务 ID,用于作业状态查询。 |
task_status | string | PENDING | 异步模式下的任务状态。
|
business_code | string | 0 | 业务码。 |
error_msg | string | 如有异常,会返回详细错误信息。 |
# 请将 OUTPUT_TOS_PATH 设置为本账号上可写入的 tos 路径 export OUTPUT_TOS_PATH="tos://path/to/scene_seg_results" curl --location "https://operator.las.cn-beijing.volces.com/api/v1/submit" --header "Content-Type: application/json" --header "Authorization: Bearer $LAS_API_KEY" --data '{ "operator_id": "las_video_scene_seg", "operator_version": "v1", "data": { "video_url": "https://las-ai-qa-online.tos-cn-beijing.volces.com/operator_cards_serving/public/qa/las_video_scene_seg/v1/sample_video.mp4", "output_tos_path": "$OUTPUT_TOS_PATH", "min_segment_duration": 4.0, "max_segment_duration": 10.0, "seg_mode": "precise" } }'
{ "metadata": { "task_id": "task-20260323153012-abc123", "task_status": "PENDING", "business_code": "0", "error_msg": "" } }
调用视频分镜算子提交异步任务,支持场景切分、人物提取、场景切片和结果上传。
参数 | 类型 | 必填 | 示例值 | 说明 |
|---|---|---|---|---|
operator_id | string | 是 | las_video_scene_seg | 算子 ID |
operator_version | string | 是 | v1 | 算子版本 |
task_id | string | 是 | task-xxx | 任务 ID |
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
metadata | metadata | 请求元信息 | |
task_id | string | task-xxx | 异步模式下的任务 ID。 |
task_status | string | COMPLETED | 异步模式下的任务状态。
|
business_code | string | 0 | 业务码。 |
error_msg | string | 如有异常,会返回详细错误信息。 | |
data | VideoSceneSegResponse | 返回的数据 | |
video_duration | float | 98.4 | 输入视频总时长(秒)。 |
segment_count | integer | 12 | 切分出的场景数量。 |
character_count | integer | 5 | 识别出的全局人物数量。 |
segments_url | string | tos://bucket/output/run_id>/segments.json | 场景结果 JSON 地址,每个元素对应一个场景对象。 |
characters_registry_url | string | tos://bucket/output/run_id>/characters_registry.json | 人物注册表 JSON 地址。 |
curl --location "https://operator.las.cn-beijing.volces.com/api/v1/poll" --header "Content-Type: application/json" --header "Authorization: Bearer $LAS_API_KEY" --data '{ "operator_id": "las_video_scene_seg", "operator_version": "v1", "task_id": "task-20260323153012-abc123" }'
{ "metadata": { "task_id": "task-20260323153012-abc123", "task_status": "COMPLETED", "business_code": "0", "error_msg": "" }, "data": { "video_duration": 98.4, "segment_count": 12, "character_count": 5, "segments_url": "tos://path/to/scene_seg_results/9f4b7c3d12ab_20260323_153012/segments.json", "characters_registry_url": "tos://path/to/scene_seg_results/9f4b7c3d12ab_20260323_153012/characters_registry.json" } }
HttpCode | 错误码 | 错误信息 | 说明 |
|---|---|---|---|
400 | Url.Invalid | The url is invalid. | 视频链接不合法。 |
400 | Video.Invalid | The video file is invalid. | 视频文件不合法或无法解析。 |
400 | Video.DownloadFailed | Video download failed. | 视频下载失败。 |
400 | Video.FormatUnsupported | Video format not supported. | 视频格式不支持。 |
400 | Parameter.Invalid | The parameter is invalid. | 参数不合法,例如 |
400 | Video.Timeout | Video processing timeout. | 视频处理超时。 |
400 | Video.ModelFailed | VLM call failed. | VLM 调用失败,导致场景切分或人物识别失败。 |
400 | Video.FrameExtractionFailed | Frame extraction failed. | 抽帧失败。 |
400 | Video.UploadFailed | Video upload failed. | 场景视频、JSON 结果或人物图片上传失败。 |
400 | Tos.AccessFailed | TOS access failed. | TOS 访问失败。 |
401 | Authorization.Missing | Missing Authorization. | 缺少鉴权。 |
401 | ApiKey.InValid | The api key is invalid. | API 不合法。 |
500 | Internal.ServerError | Internal server error. | 服务内部错误,例如未能切分出任何场景、未识别出任何人物、人物图片提取失败等。 |