You need to enable JavaScript to run this app.
文档中心
AI 数据湖服务

AI 数据湖服务

复制全文
下载 pdf
视频处理
人脸模糊
复制全文
下载 pdf
人脸模糊

人脸模糊算子,面向视频内容的自动化人脸模糊处理工具。算子能够自动识别视频中的人脸,并根据用户指定的模糊等级,对人脸进行模糊处理,保护用户隐私。

算子介绍

算子 ID : las_face_blur

应用场景

场景

描述

隐私保护

在社交媒体、视频分享平台中自动模糊人脸,保护用户隐私

内容审核

对用户上传的视频进行人脸模糊处理,满足合规要求

视频制作

在新闻、纪录片等制作中保护受访者隐私

训练/评测数据集中的人脸模糊预处理

在训练/评测模型时,对数据集中的视频帧进行人脸模糊处理,提高模型泛化能力

核心能力

  • 自动检测视频帧中的人脸并进行模糊处理
  • 支持多种模糊类型(马赛克、高斯)
  • 支持多种不同区域的精细模糊(如脸部椭圆形模糊、贴脸型模糊、眼部区域模糊等)
  • 统一输出模糊后的视频路径(即使未检测到人脸也会重新编码输出)

效果展示

  • 输入视频
  • 人脸椭圆模糊
  • 人脸马赛克模糊
  • 贴脸模糊
  • 眼部模糊

支持的地域

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

算子性能

细分项
性能影响说明

耗时

  • 与视频时长正相关。

输入与输出要求

输入要求

细分
详细说明

支持的输入数据模态

  • 视频

输入格式:视频

  • 格式:mp4, mov, avi, mkv、flv、webm 等常见格式
  • 大小:最大 10 GB。

输入路径要求

通过请求参数 video_url提供给算子输入数据,当前支持公网 URL、TOS 路径这几种方式。

  • 公网 URL:公网可访问的视频 URL,格式为 http/https
  • TOS 路径:将待处理数据上传至与当前 LAS 服务同主账号、同地域的 TOS Bucket后,可提供 TOS 路径,格式为tos://bucket_name/demo

输出要求

细分
详细说明

输出数据模态

  • 视频

输出格式:视频

  • 格式、分辨率、时长等与原视频保持一致

输出路径:TOS

通过请求参数output_tos_path 指定算子输出结果的存储路径,当前支持设置为 TOS 路径。

  • TOS 路径:与LAS服务同主账号、同地域下,有可写权限的 TOS Bucket 目录。

计费说明
  • 计费标准

    细分项
    计费标准说明

    计费项

    按输出视频的时长统计用量进行计费。

    计费类型

    按量计费,单位:元/分钟,按实际的计费用量每小时出账。

    单价

    0.1 元/分钟

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

注意与前提

细分项

注意与前提

开通 LAS

  • 如果您是一个全新的火山引擎用户,此前未开通过 LAS 产品,您可先开通 LAS,不使用 LAS 的计费功能仅开通 LAS 产品不会产生费用。开通操作请参见准备工作
  • 开通完成后可查看算子介绍文档,了解算子能力、上手引导等,详情可参见:LAS 智能数据处理算子

费用

调用算子前,您需先了解使用算子时的模型调用费用,详情请参见大模型调用计费

鉴权(API Key)

调用算子前,您需要先生成算子调用的API Key,并建议将API Key配置为环境变量,便于更安全地调用算子,详情请参见获取 API Key 并配置

BaseURL

调用算子前,您需要先根据您当前使用的LAS服务所在地域,了解算子调用的BaseURL,用于配置算子调用路径参数取值。
详情请参见获取 Base URL,下文中的调用示例仅作为参考,实际调用时需替换为您对应地域的路径取值。

Rest API 调用

Submit

接口说明

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

请求参数

参数
类型
是否必填
示例值
描述
operator_id
string
las_face_blur
本算子的id是 las_face_blur
operator_version
string
v1
目前只支持v1。
data
FaceBlurReqParams
算子参数

返回数据

参数
类型
示例值
描述
metadata
metadata
请求元信息

示例

请求示例

# 请将 OUTPUT_PATH_TEMPLATE 设置为本账号上可写入的tos路径
export OUTPUT_PATH_TEMPLATE="tos://xxxx/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://xxxx/sample.mp4",
        "output_tos_path": "$OUTPUT_PATH_TEMPLATE"
    }
}'

返回示例

{
  "metadata": {
    "task_id": "task-20251125163544-abc123",
    "task_status": "PENDING",
    "business_code": "0",
    "error_msg": ""
  }
}

错误码

HttpStatusCode

错误码

错误信息

描述

400

Parameter.Invalid

The parameter is invalid.

参数不合法

401

Authorization.Missing

Missing Authorization.

缺少鉴权

401

ApiKey.InValid

The api key is invalid.

API不合法

Poll

接口说明

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

请求参数

名称

类型

是否必选

示例值

描述

operator_id

string

las_face_blur

算子 ID

operator_version

string

v1

算子版本

task_id

string

task-xxx

任务 ID

返回数据

参数
类型
示例值
描述
metadata
metadata
请求的元信息。
data
FaceBlurResponse
返回的数据。

示例

请求示例

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": "task-20251125163544-abc123"
}'

返回示例

{
  "metadata": {
    "task_id": "06ecbd66031e7006022d",
    "task_status": "COMPLETED",
    "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
  }
}

错误码

HttpStatusCode

错误码

错误信息

描述

400

Parameter.Missing

Missing required parameter.

请求体中缺少必须的参数

400

Parameter.Invalid

Invalid parameter.

参数不合法

400

Url.Invalid

Invalid URL.

视频 URL 无法访问或不存在

400

Video.Invalid

Invalid video file.

视频格式不支持或文件损坏

400

Video.DownloadFailed

Video download failed.

下载异常或访问失败

400

Ffmpeg.error

Failed to process video.

通过FFmpeg处理视频数据失败

最近更新时间:2026.06.24 14:24:57
这个页面对您有帮助吗?
有用
有用
无用
无用