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

AI 数据湖服务

复制全文
下载 pdf
视频处理
视频分辨率调整(在线)
复制全文
下载 pdf
视频分辨率调整(在线)

算子介绍

算子 ID : las_video_resize

核心能力

视频分辨率调整

  • 智能分辨率调整到指定范围内
  • 支持多种宽高比保持策略
  • 可控制视频质量和编码参数
  • 保持音频流不受影响

效果展示

  • 输入视频
  • 输出视频

支持的地域

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

算子性能

细分项
性能影响说明

最大 RPM

600

最大并发数

10

调整结果质量

  • CPU编码 (libx264):质量优先,压缩效率高,速度较慢
  • GPU编码 (h264_nvenc):速度快,适合批量处理,质量略低于libx264(相同码率下),压缩效率稍差,文件可能更大

输入与输出要求

输入要求

细分

详细要求

支持的输入数据模态

  • 视频

输入格式:视频

  • 格式:常规视频格式均支持,包括"mp4", "mov", "mkv", "avi"等
  • 大小:时长 1 秒~2 小时、文件大小不超过 5 GB 的视频。

输入路径要求

通过请求参数 video_path 提供给算子输入数据,当前支持 TOS 路径这种方式。

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

输出要求

细分

详细要求

输出数据模态

  • 视频

输出路径:TOS

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

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

计费说明
  • 计费标准

    细分项
    计费标准说明

    计费项

    输入视频时长统计用量进行计费。

    计费类型

    按量计费,单位:元/分钟,按实际的计费用量每小时出账。计费精度:秒级精度,去尾

    单价

    与输入视频的编码格式、视频的分辨率有关。

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

    输入视频编码格式
    输出视频分辨率
    单价

    H.265

    4k

    1.05 元/分钟

    2k

    0.525 元/分钟

    1080p

    0.244 元/分钟

    720p

    0.122 元/分钟

    540p

    0.102 元/分钟

    480p

    0.081 元/分钟

    360p

    0.054 元/分钟

    240p

    0.043 元/分钟

    H.264

    4k

    0.21 元/分钟

    2k

    0.105 元/分钟

    1080p

    0.049 元/分钟

    720p

    0.024 元/分钟

    540p

    0.02 元/分钟

    480p

    0.016 元/分钟

    360p

    0.011 元/分钟

    240p

    0.009 元/分钟

注意与前提

细分项

注意与前提

开通 LAS

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

费用

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

鉴权(API Key)

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

BaseURL

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

Rest API 调用

API 调用说明

  • 本算子的 API 为异步任务接口,您需要通过 Submit 接口提交任务获得任务的 task_id,再通过 Poll 接口获取对应任务(task_id)运行状态,并获取算子处理结果。
  • 注意,任务提交后,任务的 task_id 有效期为 3 天,超过 3 天后即无法通过此 task_id 来获取算子处理结果。

Submit

POST https://operator.las.cn-beijing.volces.com/api/v1/submit

接口说明

提交 las_video_resize 算子调整视频分辨率任务。

请求参数

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

返回参数

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

示例

请求示例

# 请将 INPUT_PATH 设置为 保存在本账号下的视频文件TOS路径
export INPUT_PATH="tos://xxxx/sample.mp4"
# 请将 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_video_resize\",
    \"operator_version\": \"v1\",
    \"data\": {
        \"video_path\": \"$INPUT_PATH\",
        \"output_tos_dir\": \"$OUTPUT_PATH_TEMPLATE\",
        \"output_file_name\": \"demo1.mp4\",
        \"min_width\": \"890\",
        \"max_width\": \"890\",
        \"min_height\": \"890\",
        \"max_height\": \"890\"
    }
}"

返回示例

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

Poll

POST https://operator.las.cn-beijing.volces.com/api/v1/poll

接口说明

查询视频分辨率调整任务的执行状态和结果。

请求参数

参数

类型

必填

示例值

说明

operator_id

string

las_video_resize

算子 ID

operator_version

string

v1

算子版本

task_id

string

task-xxx

任务 ID

返回数据

参数
类型
示例值
说明
metadata
metadata
-
请求的元信息。
task_status
string
COMPLETED
任务状态。
  • PENDING, 接收到请求
  • RUNNING, 正在运行
  • COMPLETED, 已经完成
  • FAILED, 失败
submit_time
string
2026-07-21T16:04:06+08:00
任务提交时间,格式为 ISO 8601 时间戳。
end_time
string
2026-07-21T16:04:06+08:00
任务结束时间,格式为 ISO 8601 时间戳。
business_code
string
ApiKey.Invalid
业务码。
error_msg
string
The api key is invalid.
如有异常,会返回详细的异常信息。
request_id
string
9fed0e5f0659b128bad47e971aed3c81
请求的request_id。
data
VideoResizeResponse
-
返回的数据。
input_path
string
tos://bucket/key
待转换视频文件的可下载地址
output_path
string
tos://bucket/key
转换后视频文件的存储目标地址
duration
float
5.89
视频总时长,单位:秒
width
string
1780
转换结果视频宽度,单位:像素
height
string
890
转换结果视频高度,单位:像素

示例

请求示例

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

返回示例

{
    "metadata": {
        "task_id": "06ecbd66031e7006022d",
        "task_status": "COMPLETED",
        "submit_time": "2026-07-21T16:04:06+08:00",
        "end_time": "2026-07-21T16:04:06+08:00",
        "business_code": "0",
        "error_msg": "Task processed successfully"
    },
    "data": {
        "input_path": "tos://xxx/xxx.mp4",
        "output_path": "tos://yyy/result/demo1.mp4",
        "duration": 32.512,
        "width": 1780,
        "height": 890
    }
}
最近更新时间:2026.08.18 10:35:47
这个页面对您有帮助吗?
有用
有用
无用
无用