You need to enable JavaScript to run this app.
AI 数据湖服务

AI 数据湖服务

复制全文
视频修复
视频修复
复制全文
视频修复

算子介绍

描述

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

使用限制

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

核心功能

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

性能说明

  • 总耗时与视频时长、内容复杂度、网络环境相关。
  • 建议在火山内网环境下访问 TOS 源与写入 TOS 结果以获得更稳定的网络性能。
  • 不同处理模式的性能与成本平衡:
    • lite 模式:速度快、成本低
    • pro 模式:高质量、成本较高

注意与前提

细分项

注意与前提

费用

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

鉴权(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
VideoInpaintUserReqParams
-
视频修复请求参数

返回参数

参数
类型
示例值
说明
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://las-****/watermark_video.mp4",
        "output_tos_path": "$OUTPUT_TOS_PATH",
        "targets": ["subtitle"]
    }
}'

返回示例

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

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": "200",
        "error_msg": ""
    },
    "data": {
        "inpainted_video_path": "tos://bucket/output/video_inpaint/xxx/output.mp4",
        "subtitle_bbox": "120,800,1800,960",
        "resolution": "1920x1080"
    }
}

错误码

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.

服务内部错误

最近更新时间:2026.03.10 12:03:40
这个页面对您有帮助吗?
有用
有用
无用
无用