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

AI 数据湖服务

复制全文
下载 pdf
视频修复
视频修复
复制全文
下载 pdf
视频修复

算子介绍

描述

视频智能修复算子,基于多模态大模型实现视频水印和字幕智能擦除能力。支持自动检测和擦除视频中的水印、字幕、logo等不需要的内容,输出修复后的视频文件。

使用限制

  • 需要能访问视频源文件(公网、火山内网或 TOS)。
  • 视频时长限制为最长 3 小时。
  • 视频大小限制为最大 10GB。
  • 支持的视频格式:mp4, mov, avi, mkv 等常见格式。

核心功能

  • 支持多种目标擦除:水印、字幕、滚动字幕等。
  • 基于多模态大模型的智能检测,精准定位需要修复的区域。
  • 支持精确 mask 生成,保留边缘细节。
  • 支持视频分段处理,处理长视频更稳定。
  • 自动处理音频保留,无需额外操作。
  • 支持输出 TOS 地址,结果自动上传。

性能说明

  • 总耗时与视频时长、内容复杂度、网络环境相关。
  • 建议在火山内网环境下访问 TOS 源与写入 TOS 结果以获得更稳定的网络性能。
  • 服务计费与视频时长、输出帧率关联。平台基础计费基准帧率为 30fps,若输出帧率高于 30fps,将按照对应帧率倍率系数折算计费;示例:60fps 计费系数 2.0。

注意与前提

细分项

注意与前提

开通 LAS

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

费用

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

鉴权(API Key)

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

BaseURL

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

Rest API 调用

Submit

接口说明

调用视频修复算子提交修复任务,支持对公网,火山内网或 TOS 视频源文件进行水印、字幕、logo等内容的智能擦除。

请求参数

参数
类型
是否必填
示例值
说明
operator_id
string
las_video_inpaint
算子 ID
operator_version
string
v1
算子版本
data
VideoInpaintUserRequest
视频修复请求参数

返回参数

参数
类型
示例值
说明
metadata
metadata
-
请求元信息

示例

请求示例

# 请将 OUTPUT_TOS_PATH 设置为本账号上可写入的tos路径
export OUTPUT_TOS_PATH="tos://path/to/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_video_inpaint",
    "operator_version": "v1",
    "data": {
        "video_url": "https://*****/watermark_video.mp4",
        "output_tos_path": "$$OUTPUT_TOS_PATH",
        "targets": ["watermark", "subtitle"]
    }
}'

返回示例

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

错误码

HttpCode

错误码

错误信息

说明

400

Url.Invalid

The url is invalid.

视频链接不合法

400

Video.Invalid

The video file is invalid.

视频文件不合法

400

Video.DurationExceeded

Video duration exceeds maximum limit of 4 hours.

视频时长超出最大限制

400

Video.FileTooLarge

Video file size exceeds maximum limit of 30GB.

视频文件大小超出限制

400

Parameter.Invalid

The parameter is invalid.

参数不合法

401

Authorization.Missing

Missing Authorization.

缺少鉴权

401

ApiKey.InValid

The api key is invalid.

API不合法

400

Video.DurationTooShort

Video duration is too short, minimum 1 second required.

视频时长过短

400

Video.Timeout

Video processing timeout.

视频处理超时

500

Internal.ServerError

Internal server error.

服务内部错误

Poll

接口说明

查询视频修复任务的执行状态和结果。

请求参数

参数

类型

必填

示例值

说明

operator_id

string

las_video_inpaint

算子 ID

operator_version

string

v1

算子版本

task_id

string

task-xxx

任务 ID

返回数据

参数
类型
示例值
说明
metadata
metadata
请求元信息
data
VideoInpaintResponse
返回的数据

示例

请求示例

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_inpaint",
    "operator_version": "v1",
    "task_id": "task-20251125163544-abc123"
}'

返回示例

{
    "metadata": {
        "task_id": "task-20251125163544-abc123",
        "task_status": "COMPLETED",
        "business_code": "0",
        "error_msg": ""
    },
    "data": {
        "inpainted_video_path": "tos://bucket/output/video_inpaint/xxx/output.mp4",
        "subtitle_bbox": "120,800,1800,960",
        "resolution": "1920x1080"
    }
}

错误码

HttpStatusCode

错误码

错误信息

描述

400

MISSING_REQUIRED_PARAMETER

Missing required parameter.

缺少必选参数

400

INVALID_PARAMETER

Invalid parameter.

参数不合法

400

INVALID_URL

Invalid URL.

URL 不合法

400

INVALID_VIDEO_FILE

Invalid video file.

视频文件无效

400

VIDEO_DOWNLOAD_FAILED

Video download failed.

视频下载失败

400

VIDEO_FORMAT_UNSUPPORTED

Video format not supported.

视频格式不支持

400

VIDEO_TIMEOUT

Video processing timeout.

视频处理超时

400

VLM_CALL_FAILED

VLM call failed.

VLM 调用失败

400

VIDEO_UPLOAD_FAILED

Video upload failed.

视频上传失败

400

TOS_ACCESS_FAILED

TOS access failed.

TOS 访问失败

401

Authorization.Missing

Missing Authorization.

缺少鉴权

401

ApiKey.InValid

The api key is invalid.

API不合法

400

Task.NotFound

Task not found.

任务不存在

500

Internal.ServerError

Internal server error.

服务内部错误

最近更新时间:2026.04.23 18:43:10
这个页面对您有帮助吗?
有用
有用
无用
无用