LAS 视频修复（lasvideoinpaint）

本 Skill 基于以下两个接口，封装 submit/poll 异步调用流程。

• - POST https://operator.las.cn-beijing.volces.com/api/v1/submit 提交修复任务
• POST https://operator.las.cn-beijing.volces.com/api/v1/poll 轮询任务状态并拿到修复后视频

你需要准备什么

• - LASAPIKEY：优先从环境变量读取；也支持放在当前目录的 env.sh
• Operator Region（二选一）：

• - videourl：可下载的视频地址（http/https 或 tos://bucket/key）
• outputtospath：修复结果写入的 TOS 路径前缀（建议传目录前缀）。实际输出以 inpaintedvideo_path 为准

参数与返回字段（详细版）

完整速查见：

• - references/api.md

推荐使用方式

本 Skill 自带可执行脚本：scripts/skill.py。

下面示例默认你位于该 Skill 目录（与 SKILL.md 同级），因此命令使用相对路径 scripts/skill.py。

1) 仅提交（返回 task_id）

bash
python3 scripts/skill.py submit \
--video-url tos://bucket/input.mp4 \
--output-tos-path tos://bucket/output/ \
--targets watermark \
--targets subtitle \
--region cn-beijing \
--out submit.json

2) 查询任务状态（poll）

bash
python3 scripts/skill.py poll task-xxx \
--region cn-beijing \
--out result.json

建议在对话中继续处理其他问题；每隔一段时间（例如 5-10 秒）再 poll 一次，直到 taskstatus=COMPLETED 后把 data.inpaintedvideo_path 返回给用户。

关键参数说明

• - targets：擦除目标类型，常用 watermark/subtitle/scrollingsubtitle，默认服务端通常为 [watermark,subtitle]
• fixedbboxes：如果你只想修复某些固定区域，可用该参数。坐标以 1000x1000 为基准，会按实际分辨率缩放
• returnsubtitlebbox：是否返回字幕 bbox（字符串 x1,y1,x2,y2，原视频像素坐标）
• 如果你传入的是带 .mp4 的路径（看起来像文件），服务端可能仍会在该路径下追加任务目录与文件名；建议使用目录前缀，避免出现 ...mp4//.mp4 的层级

使用限制（摘要）

• - 视频源需可访问（公网/火山内网/TOS）
• 视频时长 ≤ 4 小时，大小 ≤ 30GB

补充：本地文件作为输入输出

lasvideoinpaint 输入支持TOS或可下载URL，输出必须写入 TOS 上（最终以 inpaintedvideopath 为准）。当用户给的是本地文件路径或希望本地落盘时，按下面规则处理，并配合 byted-tosfile-access 做上传/下载中转。

规则

• - 用户输入是本地路径：先用 byted-tosfile-access 上传到 TOS，得到 tos://... 再作为 --video-url 调用本技能。
• 用户输出要求是本地路径：本技能先输出到 TOS（中转），待 COMPLETED 后用 byted-tosfile-access 把 inpaintedvideopath 下载到本地。
• 用户输入与输出都要求本地：必须追问用户提供一个“可写的 TOS 中转目录前缀”（例如 tos://bucket/tmp/videoinpaint/），用它同时承载上传的输入与算子输出。
• 用户输入或输出有一项已经是 tos://... 且仍需要中转：优先复用该 bucket，并通过“路径改写”生成中转前缀，例如把 tos://bucket/a/b/input.mp4 改写成 tos://bucket/a/b/videoinpaint/（或 tos://bucket/a/b/tmp/video_inpaint/），避免覆盖原文件。