人脸模糊算子面向视频内容提供两种处理模式：自动识别视频中的人脸并按指定等级进行模糊处理以保护隐私，或仅执行人脸检测并将逐帧人脸边界框输出为 JSON 文件，不修改视频内容。

算子 ID : las_face_blur

应用场景 #

核心能力 #

• 支持模糊模式，可对输入视频中的人脸进行模糊处理，返回模糊处理后的视频。
  • 自动检测视频帧中的人脸并进行模糊处理；
  • 支持多种模糊类型（马赛克、高斯）；
  • 支持多种不同区域的精细模糊（如脸部椭圆形模糊、贴脸型模糊、眼部区域模糊等）。
• 支持检测模式（blur_mode=detect），仅返回逐帧人脸 bbox JSON 文件，不输出处理后的视频。
• 模糊模式统一输出视频路径，检测模式输出 JSON 结果路径。

效果展示 #

支持的地域 #

• 北京：cn-beijing
• 上海：cn-shanghai
• 广州：cn-guangzhou

算子性能 #

输入要求 #

输出要求 #

• 计费标准

  细分项	计费标准说明
  计费项	按输出视频的时长统计用量进行计费。
  计费类型	按量计费，单位：元/分钟，按实际的计费用量每小时出账。计费精度：四舍五入
  单价	0.1 元/分钟

• 计费详情
  计费公式：总费用 = 单价 * 用量

API 调用说明 #

• 本算子的 API 为异步任务接口，您需要通过 Submit 接口提交任务获得任务的 task_id，再通过 Poll 接口获取对应任务（task_id）运行状态，并获取算子处理结果。
• 注意，任务提交后，任务的 task_id 有效期为 3 天，超过 3 天后即无法通过此 task_id 来获取算子处理结果。

Submit #

接口说明 #

提交 las_face_blur 算子进行人脸模糊任务。

请求参数 #

返回数据 #

示例 #

请求示例

# 请将 OUTPUT_PATH_TEMPLATE 设置为本账号上可写入的tos路径
export OUTPUT_PATH_TEMPLATE="tos://<your_bucket_name>/output/"
# 发起算子服务请求
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_face_blur",
    "operator_version": "v1",
    "data": {
        "url": "tos://<your_bucket_name>/sample.mp4",
        "output_tos_path": "'$OUTPUT_PATH_TEMPLATE'"
    }
}'

返回示例

{
  "metadata": {
    "task_id": "<YOUR_TASK_ID>",
    "task_status": "PENDING",
    "business_code": "0",
    "error_msg": ""
  }
}

错误码 #

Poll #

接口说明 #

查询人脸模糊任务的执行状态和结果。

请求参数 #

返回数据 #

detect 模式返回的 JSON 文件说明

当 blur_mode=detect 时，output_tos_uri 和 output_url 指向一个 JSON 文件。该文件包含输入视频的人脸检测结果，不是处理后的视频。

• JSON 文件的字段结构

  收起全部

  字段	类型	说明
  video	VideoMeta	输入视频元数据。
  fps	float	输入视频帧率。
  width	int	输入视频宽度，单位为像素。
  height	int	输入视频高度，单位为像素。
  total_frames	int	输入视频总帧数。
  duration_seconds	float	输入视频时长，单位为秒。
  summary	Summary	人脸检测结果总结。
  total_faces	int	所有帧累计检测到的人脸数量。
  frames_with_faces	int	包含至少一个人脸的帧数。
  max_faces_in_frame	int	单帧检测到的最大人脸数。
  box_format	string	bbox 坐标格式，默认为 [x1, y1, x2, y2]。
  frames	list[Frame]	包含至少一个检测到人脸的帧列表。未检测到人脸的帧不会出现在该列表中。
  frame_index	int	输入视频中的帧索引。
  faces	list[FaceBBox]	当前帧检测到的人脸 bbox 列表。
  box	list[int]	bbox 坐标，顺序由 box_format 指定。
  confidence	float	当前 bbox 的检测置信度。

• 示例

  {
    "video": {"fps": 30.0, "width": 1280, "height": 960, "total_frames": 5376, "duration_seconds": 179.2},
    "summary": {"total_faces": 3710, "frames_with_faces": 3710, "max_faces_in_frame": 1},
    "box_format": "[x1, y1, x2, y2]",
    "frames": [
      {"frame_index": 489, "faces": [{"box": [917, 3, 1001, 70], "confidence": 0.644342}]},
      {"frame_index": 490, "faces": [{"box": [915, 3, 1003, 72], "confidence": 0.807955}]}
    ]
  }
  

示例 #

请求示例

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_face_blur",
    "operator_version": "v1",
    "task_id": "<YOUR_TASK_ID>"
}'

返回示例

{
    "metadata": {
        "task_id": "06ecbd66031e7006022d",
        "task_status": "COMPLETED",
        "submit_time": "2026-07-21T16:04:06+08:00",
        "end_time": "2026-07-21T16:04:06+08:00",
        "business_code": "0",
        "error_msg": "Task processed successfully"
    },
    "data": {
        "output_tos_uri": "tos://{bucket}/xxx.mp4",
        "output_url": "https://{bucket}.tos-cn-beijing.volces.com/xxx.mp4?xxx",
        "duration_seconds": 123.36
    }
}

错误码 #