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

AI 数据湖服务

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

算子介绍

描述

视频分辨率调整

核心功能

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

格式支持:

  • MP4 (.mp4)
  • AVI (.avi)
  • MOV (.mov)
  • MKV (.mkv)
  • 其他常见视频格式

编码模式

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

计费说明
  • 计费标准

    细分项
    计费标准说明

    计费项

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

    计费类型

    按量计费,单位:元/分钟,按实际的计费用量每小时出账。

    单价

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

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

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

    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,下文中的调用示例仅作为参考,实际调用时需替换为您对应地域的路径取值。

其他

当前算子的调用并发限制在 100 QPM。如果有更大的并发需求,请联系 LAS-AI 团队提相应工单**。**

Rest API 调用

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
-
算子参数
video_path
string
tos://xxx/video.mp4
待转换视频文件的可下载地址。支持火山 TOS (tos://bucket/key)。
output_tos_dir
string
tos://testbucket/path/
转换后音频文件的存储目标目录。支持火山 TOS (tos://bucket/key)。
output_file_name
string
result.mp4
转换后的结果文件名称,非必须。如果未填写,则结果文件名为 源文件名_resized.mp4
min_width
integer
1280
视频最小宽度,小于该值时将被调整。单位:像素
max_width
integer
2560
视频最大宽度,大于该值时将被调整。单位:像素
min_height
integer
1280
视频最小高度,小于该值时将被调整。单位:像素
max_height
integer
2560
视频最大高度,大于该值时将被调整。单位:像素
force_original_aspect_ratio_type
string
increase
force_original_aspect_ratio_type: 宽高比保持策略。
disable: 不强制保持原始宽高比,可能会拉伸变形
increase: 保持宽高比,调整到大于等于目标尺寸
decrease: 保持宽高比,调整到小于等于目标尺寸
可选值:["disable", "increase", "decrease"]
默认值:"increase"
force_divisible_by
integer
2
像素对齐步长,确保宽高能被该值整除。默认值: 2
cq
integer
0
NVENC编码器的质量控制参数。适用:仅在GPU编码(h264_nvenc)时使用
范围:0-51,0表示自动质量控制
推荐:0(自动) 或 18-28(手动控制)
默认值: 0
rc
string
vbr
NVENC编码器的码率控制模式。适用:仅在GPU编码(h264_nvenc)时使用
constqp: 恒定量化参数,质量稳定
vbr: 变码率,平衡质量和文件大小
cbr: 恒定码率,适合流媒体传输
推荐:"vbr"(通用) "cbr"(直播)
默认值: "vbr"

返回参数

参数
类型
示例值
说明
metadata
metadata
-
请求元信息
task_id
string
task-xxx
异步模式下的任务 ID,用于作业状态查询。
task_status
string
PENDING
异步模式下的任务状态。
  • PENDING, 接收请求
  • RUNNING, 正在运行
  • COMPLETED, 已经完成
  • FAILED, 失败
  • TIMEOUT, 超时
business_code
string
200
业务码。
error_msg
string
-
如有异常,会返回详细的异常信息。

示例

请求示例

# 请将 INPUT_PATH 设置为 保存在本账号下的视频文件TOS路径
export INPUT_PATH="tos://xxxx/sample.mp4"
# 请将 OUTPUT_PATH_TEMPLATE 设置为本账号上可写入的tos路径
export OUTPUT_PATH_TEMPLATE="tos://xxxx/output"
# 发起算子服务请求
curl --location "operator.las.cn-beijing.volces.com/api/v1/process" \
--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_status": "COMPLETED",
        "business_code": "0",
        "error_msg": "",
        "request_id": "c7b29d78a99f88beda5497753ed60816"
    },
    "data": {
        "audios": [
            {
                "input_path": "tos://xxx/sample.mp3",
                "output_path": "tos://xxx/sample.mp3.wav4",
                "duration": 49.711,
                "status": "success"
            }
        ]
    }
}

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
任务状态。
  • ACCEPTED, 接收到请求
  • RUNNING, 正在运行
  • COMPLETED, 已经完成
  • FAILED, 失败
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",
        "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.06.12 18:26:48
这个页面对您有帮助吗?
有用
有用
无用
无用