SuperAPI AI 工具集

byted-las-video-resize

设计与创作

查看项目

更新于 10-15 17:30

技能介绍

用途:这是火山引擎 LAS 的视频分辨率调整算子(las_video_resize),把视频缩放到指定的宽高范围,支持宽高比保持策略,并使用 GPU NVENC 编码。它采用 Tool Wrapper 封装 lasutil CLI 调用,并以 Step 0 到 Step N 的顺序流水线工作流执行。核心为算子 ID las_video_resize 与异步 API(submit 后 poll),必填环境变量为 LAS_API_KEY,参数与接口定义见 references/api.md。

主要能力:支持指定 min_width/max_width 与 min_height/max_height 的分辨率范围;通过 force_original_aspect_ratio_type 控制宽高比策略;强制固定尺寸需设置 min_width=max_width、min_height=max_height 且 force_original_aspect_ratio_type=disable;输出视频写入指定的 output_tos_dir。

使用方式:先做前置检查,确认 LAS_API_KEY 与 LAS_REGION(常见 cn-beijing,且须与 API Key、TOS Bucket 地域一致),确认输入与输出路径,output_tos_dir 为必填、须由用户提供自己可写的 TOS 目录(tos://bucket/output_dir/)。随后执行环境初始化:source "$(dirname "$0")/scripts/env_init.sh" las_video_resize,并取 workdir=$LAS_WORKDIR。本地文件用 lasutil file-upload <local_path> 上传(只需 LAS_API_KEY),取返回的 presigned_url(24 小时有效)作为输入 URL。查询时长用 lasutil media-duration <video_url>,再据 references/prices.md 预估价格并等待用户确认。提交用 lasutil submit las_video_resize "$data",成功后须返回 task_id;查询用 lasutil poll las_video_resize {task_id},COMPLETED 时读取 result.data.output_path。若环境不支持后台轮询,不得死循环等待,应输出 Task ID 并结束当前轮次。

限制与注意事项:输出目录必须用户自备且可写;若需把结果从 TOS 下载回本地,需要 VOLCENGINE_ACCESS_KEY 与 VOLCENGINE_SECRET_KEY,仅上传输入文件时不需要 TOS 凭证;切换 Region 须同步更换 TOS Bucket。密钥被聊天框屏蔽时,可让用户在目录创建 env.sh 写入 export LAS_API_KEY="..."。计费为预估计费,实际以火山账单为准;最终回复须包含相关计费声明,禁止用“实际费用”描述预估价。其余计费细则与定价暂未提供。