视频智能包装算子为已剪好的竖屏视频补齐字幕、重点表达、配乐和视觉包装，并交付完整成片、无字幕版、SRT 与包装方案。

算子介绍

适用场景

场景	描述
产品口播	识别或导入字幕，增加关键词高亮、信息卡、配乐与音效。
营销素材	为多段竖屏视频统一包装风格、转场与节奏。
生活服务与纪实内容	保留原声并自动规划字幕特效、BGM 和视觉元素。

核心能力

多种字幕来源：逐视频使用 ASR、外部 SRT，或通过口播稿校正识别文本。

重点表达：支持普通字幕、花字、关键词高亮和信息卡，并分别配置字幕和卡片样式。

画面与声音包装：支持视频间转场、1～2 倍播放速度、BGM 和音效，保留原视频声音。

素材约束：可分别限定音效、BGM、字体、字幕特效和转场候选，并支持自带 TOS 音乐。

支持的地域

北京：cn-beijing

算子性能

细分项	限制或说明
耗时	与输入总时长、素材数量、字幕来源、画面理解、包装项和目标规格相关。

输入与输出要求

输入要求

细分项	详细要求
支持的数据模态	视频文本（SRT、口播稿和包装要求）音频（自带 BGM）
输入模态：视频	格式：mp4、mov、m4v、webm、mkv、avi。数量与大小：1～20 条竖屏视频（高度须大于宽度）；单条至少 1 秒，源视频总时长不超过 30 分钟。
输入模态：文本	STR：每条视频可提供一个局部时间轴 SRT，与 script 互斥。不超过 2 MiB，支持 UTF-8（含 BOM）或 GB18030。 instruction 最多 2000 字符；单视频 script 最多 10000 字符。
输入模态：音频	格式： mp3、wav、m4a、aac、flac、ogg。数量：最多 20 条。
输入路径	公网 URL：视频和 SRT 使用 LAS 服务可直接访问的 HTTP/HTTPS 文件直链，不接受目录；使用签名 URL 时，有效期须覆盖任务排队和执行过程。 TOS 路径：使用 tos://bucket/key 格式的具体文件地址，不接受目录。TOS Bucket 须与 LAS 服务属于同一主账号、同一地域，并授予 LAS 服务目标对象的读取权限；自带 BGM 仅支持 TOS 文件。

输出要求

细分项	详细要求
支持的数据模态	视频文本（SRT、包装方案和结果 JSON）
输出模态：视频	返回完整成片和无字幕版；无新增字幕时，两者可能为同一产物。默认目标规格为 1080×1920、60 FPS、非严格模式，宽必须小于高；实际交付结果以 Poll 返回为准。
输出模态：文本	返回完整时间轴 SRT、包装方案 JSON、结果 JSON、统计和警告。
输出路径	TOS：支持通过 output_tos_path 指定 tos://bucket/prefix 格式的输出目录。 TOS Bucket 须与 LAS 服务属于同一主账号、同一地域，并授予 LAS 服务目标目录的写入权限；不传 output_tos_path 时，由 LAS 分配输出位置。最终产物的 TOS 路径和临时访问 URL 以 Poll 的 data.artifacts 为准。

计费说明

计费标准

细分项	计费标准说明
计费项	基于全部输入视频倍速前的原始时长进行统计计费。字幕、ASR 和 TTS 不另收费，提高播放倍速不会减少输入计量。
计费类型	按量计费，按实际的计费用量每小时出账。计费精度：毫秒级、按比例、不满一分钟不补整。
单价	当前支持两档智能包装任务，不同档位任务的单价不一致：带画面理解（请求参数usage.visual_understanding_duration_ms>0）：0.6 元/分钟普通包装（请求参数usage.visual_understanding_duration_ms=0）：0.3 元/分钟

注意与前提

细分项	注意与前提
开通 LAS	如果您是一个全新的火山引擎用户，此前未开通过 LAS 产品，您可先开通 LAS，不使用 LAS 的计费功能仅开通 LAS 产品不会产生费用。开通操作请参见准备工作。开通完成后可查看算子介绍文档，了解算子能力、上手引导等，详情可参见：LAS 智能数据处理算子。
费用	调用算子前，您需先了解使用算子时的模型调用费用，详情请参见大模型调用计费。
鉴权（API Key）	调用算子前，您需要先生成算子调用的API Key，并建议将API Key配置为环境变量，便于更安全地调用算子，详情请参见获取 API Key 并配置。
BaseURL	调用算子前，您需要先根据您当前使用的LAS服务所在地域，了解算子调用的BaseURL，用于配置算子调用路径参数取值。详情请参见获取 Base URL，下文中的调用示例仅作为参考，实际调用时需替换为您对应地域的路径取值。

Rest API 调用

API 调用说明

通过 Submit 获取 task_id，再调用 Poll 查询。仅在 task_status=COMPLETED 且 business_code="0" 时读取结果。

Submit

请求参数

operator_id string 必选示例值: las_video_packaging

固定为 las_video_packaging。

operator_version string 必选示例值: v1

固定为 v1。

data VideoPackagingReqParams 必选

video_urls string / list of PackagingVideoItem 必选

单个视频地址或 1～20 个地址/对象，可混用字符串和对象，按输入顺序合成。

url string 必选示例值: tos://your-bucket/edited.mp4

具体竖屏视频，高度须大于宽度；单条至少 1 秒、合计不超过 30 分钟。TOS 文件支持 mp4、mov、m4v、webm、mkv、avi。

subtitle_srt string Optional 示例值: tos://your-bucket/edited.srt

当前视频局部时间轴的 SRT，支持 TOS 或 HTTP(S)，最大 2 MiB，与 script 互斥。超时条目会截断或丢弃，重叠条目会调整并写入 warnings；不可解析时拒绝。

script string Optional

口播稿，最多 10000 字符，与 subtitle_srt 互斥。仅校正 ASR 文字，时序仍来自 ASR。

transition_in string Optional 示例值: feature_flash_white

进入当前视频的转场，首条视频不得设置。支持 none、feature_flash_white、feature_flash_gold、feature_soft_reveal、feature_accel_left/right/up/down/upleft/upright/downleft/downright、feature_zoom_punch、feature_zoom_pull、seam_punch_in、feature_spin_cut、feature_blur_dip、feature_glitch_burst。

smart_packaging PackagingSmartParams Optional

控制字幕特效、音效和 BGM；不传时三项默认开启。

enabled boolean Optional

true 时三项全开并忽略细项；false 时仅启用显式为 true 的细项。

enable_subtitle_effect boolean Optional

控制字幕特效，不关闭普通字幕。

enable_sound_effect boolean Optional

控制音效。

enable_bgm boolean Optional

控制背景音乐。

subtitle_effect_density string Optional 示例值: low

可选 low、medium、high；未填时自动决定。

bgm_volume float Optional 示例值: 0.3

配乐音量，范围 [0.2,0.8]；不填时自动决定。

bgm_segmentation string Optional 示例值: auto

auto 按内容决定，single 整片一首，per_video 每条视频一段；仅一条视频时按整片处理。

assets SmartPackagingAssets Optional

五组可选素材白名单。不传或为空对象时使用默认素材池；声明某组后仅从该组候选中选择。

sound_effect SoundEffectAssetPool Optional

音效 ID 白名单。

asset_ids list of string 必选

1～20 个以 sfx_ 开头的有效音效 ID，去重保序且不能为空。

selection string Optional 示例值: director

director 按内容选择，random 在池内随机选择。

font FontAssetPool Optional

字体白名单。

font_ids list of string 必选

1～20 个有效字体 ID，去重保序且不能为空。

selection string Optional 示例值: director

director 按内容选择，random 在池内随机选择。

subtitle_effect SubtitleEffectAssetPool Optional

花字与染色款式白名单。

effect_ids list of string 必选

1～20 个有效花字或染色款式 ID，去重保序且不能为空。

selection string Optional 示例值: director

director 按内容选择，random 在池内随机选择。

transition TransitionAssetPool Optional

视频间转场白名单。

preset_ids list of string 必选

1～20 个有效转场 ID，去重保序且不能为空，取值同 transition_in。

selection string Optional 示例值: director

director 按内容选择，random 在池内随机选择。

bgm BgmAssetPool Optional

BGM 候选池。

asset_ids list of string Conditional

内置 bgm_ ID，去重后最多 20 个；与 urls 至少一项非空。

urls list of string Conditional

用户 TOS 音频，支持 mp3、wav、m4a、aac、flac、ogg，去重后最多 20 条；与 asset_ids 至少一项非空。

source string Optional 示例值: user

提供 urls 时，user 表示仅使用自带音乐，full 表示自带音乐与内置池共同参与。

selection string Optional 示例值: director

director 按内容选择，random 随机选择。

instruction string Optional

包装偏好，最多 2000 字符，不替换字幕文字。

srt_line_break string Optional 示例值: reflow

reflow 按画宽重排，keep 保留条目结构并合并条目内换行。

subtitle_style SubtitleStyleParams Optional

普通字幕样式。

font_id string Optional

字体 ID；不填时自动选择。

font_size integer Optional 示例值: 50

正文字号，范围 [24,120] px。

keyword_font_size integer Optional 示例值: 60

关键词字号，范围 [24,120] px。

text_color string Optional 示例值: #FFFFFF

文字颜色，格式为 #RRGGBB 或 #RRGGBBAA。

outline_color string Optional 示例值: #101010

描边颜色，格式同 text_color。

outline_width integer Optional 示例值: 40

描边粗细，范围 [0,100]；0 表示不描边。

shadow_color string Optional 示例值: #000000

阴影颜色。

shadow_size integer Optional 示例值: 0

阴影距离，范围 [0,100]。

position_ratio float Optional 示例值: 0.87

字幕行垂直中心占画面高度的比例，范围 [0.05,0.95]。

background_color string Optional 示例值: #00000080

字幕背景颜色，格式同 text_color。

info_card InfoCardParams Optional

信息卡。

prompt string 必选示例值: 开头显示产品名称，结尾提示了解详情

信息卡内容与出现要求，去除首尾空白后 1～4000 字符。

position string Optional 示例值: top_left

支持 top_left、top_center、top_right、bottom_left、bottom_center、bottom_right；不传时由系统决定。

style CardTextStyleParams Optional

正文样式，不继承 subtitle_style。

font_id string Optional

有效字体 ID；不传时使用信息卡正文默认字体。

font_size integer Optional 示例值: 36

字号，范围 [24,60] px。

text_color string Optional 示例值: #FFFFFF

文字颜色，格式为 #RRGGBB 或 #RRGGBBAA。

outline_color string Optional 示例值: #101010

描边颜色，格式同 text_color。

outline_width integer Optional 示例值: 40

描边粗细，范围 [0,100]；0 表示不描边。

shadow_color string Optional 示例值: #000000

阴影颜色，格式同 text_color。

shadow_size integer Optional 示例值: 0

阴影距离，范围 [0,100]。

background_color string Optional 示例值: #00000080

背景颜色，格式同 text_color。

title_style CardTextStyleParams Optional

标题样式。

font_id string Optional

有效字体 ID；不传时使用信息卡标题默认字体。

font_size integer Optional 示例值: 36

字号，范围 [24,60] px。

text_color string Optional 示例值: #FFFFFF

文字颜色，格式为 #RRGGBB 或 #RRGGBBAA。

outline_color string Optional 示例值: #101010

描边颜色，格式同 text_color。

outline_width integer Optional 示例值: 40

描边粗细，范围 [0,100]；0 表示不描边。

shadow_color string Optional 示例值: #000000

阴影颜色，格式同 text_color。

shadow_size integer Optional 示例值: 0

阴影距离，范围 [0,100]。

background_color string Optional 示例值: #00000080

背景颜色，格式同 text_color。

visual_understanding boolean Optional 示例值: false

是否使用画面理解辅助包装；实际用量决定计费档位。

video_spec VideoSpecParams Optional

默认 1080×1920@60fps、非严格，且宽必须小于高。

width integer Optional 示例值: 1080

目标宽度，范围 [64,7680]，须与 height 同时设置。

height integer Optional 示例值: 1920

目标高度，范围 [64,7680]，须与 width 同时设置。

fps integer Optional 示例值: 60

目标帧率，范围 [1,240]。

strict boolean Optional 示例值: false

false 时素材低于目标会降低交付规格，不上采样；true 时需要上采样或帧率不足则拒收。

playback_speed float Optional 示例值: 1.0

播放倍速，范围 [1.0,2.0]。

output_tos_path string Optional 示例值: tos://your-bucket/packaging/results/

可写 TOS 输出目录；不传由平台分配。

返回数据

metadata Metadata

任务接收结果；不包含成片，需继续调用 Poll 查询。

task_id string 示例值: task-example

异步任务 ID。

task_status string 示例值: PENDING

PENDING、RUNNING 时继续轮询；COMPLETED、FAILED、TIMEOUT、EXPIRED、CANCELLED 为终态。

business_code string 示例值: 0

业务处理码，成功为字符串 0。

error_msg string

错误说明，成功时为空。

示例

多视频字幕来源与包装开关示例：

Submit 成功返回示例：

错误码

HttpStatusCode	错误码	错误信息	描述
400	Parameter.Invalid	The parameter is invalid.	请求参数类型、枚举、范围或组合不合法。
401	Authorization.Missing	Missing Authorization.	缺少鉴权信息。
401	ApiKey.Invalid	The api key is invalid.	API Key 无效。
500	Server.InternalError	General Internal Error	服务内部错误。

表中为接口请求错误。异步任务已接收后的执行失败，应以 Poll 的 metadata.task_status、business_code 和 error_msg 为准。

Poll

请求参数

名称	类型	是否必选	示例值	描述
operator_id	string	是	las_video_packaging	固定为 las_video_packaging。
operator_version	string	是	v1	固定为 v1。
task_id	string	是	task-xxx	Submit 返回的任务 ID。

返回数据

metadata Metadata

任务状态和错误信息。

task_id string 示例值: task-example

异步任务 ID。

task_status string 示例值: COMPLETED

PENDING、RUNNING 时继续轮询；COMPLETED 表示执行完成，需结合 business_code 判断成功；FAILED、TIMEOUT、EXPIRED、CANCELLED 为终态。

business_code string 示例值: 0

业务处理码，成功为字符串 0。

error_msg string

错误说明，成功时为空。

submit_time string

提交时间，ISO 8601 格式。

end_time string

任务结束时间，ISO 8601 格式；非终态可能为空。

data VideoPackagingResponse

成功终态的视频包装结果。

clazz string 示例值: las_video_packaging

固定为 las_video_packaging。

source_duration_sec float

全部输入视频倍速前原始总时长，是普通包装和带画面理解两档的计费时长。

duration_sec float

交付成片时长，已按 playback_speed 折算。

playback_speed float Optional

交付倍速，仅大于 1.0 时出现。

video_count integer

参与成片的视频数量。

subtitle_srt string

完整交付时间轴 SRT；无字幕时为空字符串。

packaging_scheme object

本次包装方案，对应 packaging_scheme_* 文件。

summary PackagingSummary

实际包装统计。

subtitle_sources list of string

按视频顺序返回 asr、srt 或 asr_script，表示语音识别、自带字幕或口播稿校正。

subtitle_cue_count integer

普通字幕句数量。

subtitle_effect_count integer

方案花字数量。

keyword_highlight_count integer

关键词染色数量。

sound_effect_count integer

音效条目数。

bgm_track_count integer

配乐段数，不一定等于不同曲目数量。

transition_count integer

非硬切转场数。

info_card_count integer

信息卡数量。

warnings list of string

降级、未生成或素材问题提示，最多 50 条；成功后也应检查。

usage PackagingUsage

用量协议。

version string

用量结构版本。

asr_duration_ms integer

ASR 处理时长，仅作计量参考，不另收费。

visual_understanding_duration_ms integer

实际画面理解时长；大于 0 时按带画面理解档计费，为 0 时按普通包装档。两档均按 source_duration_sec 计量。

output_duration_ms integer

交付视频时长，仅作计量参考，不另收费。

artifacts Artifacts

产物 TOS 路径和临时访问链接；未生成的产物通常不返回对应键。

result_json_tos_path string

完整结果 JSON 的 TOS 路径。

result_json_url string

结果 JSON 的临时下载链接。

video_subtitled_tos_path string

完整带字幕成片的 TOS 路径。

video_subtitled_url string

带字幕成片的临时下载链接。

video_clean_tos_path string

无本次新增文字层成片的 TOS 路径。

video_clean_url string

无字幕版成片的临时下载链接。

subtitle_srt_tos_path string

独立 SRT 文件的 TOS 路径。

subtitle_srt_url string

SRT 文件的临时下载链接。

packaging_scheme_tos_path string

包装方案 JSON 的 TOS 路径。

packaging_scheme_url string

包装方案 JSON 的临时下载链接。

请求示例：

成功返回示例：

错误码

HttpStatusCode	错误码	错误信息	描述
400	Parameter.Invalid	The parameter is invalid.	请求参数类型、枚举、范围或组合不合法。
400	Task.NotFound	Task not found	任务不存在、已过期或当前身份不可见。
401	Authorization.Missing	Missing Authorization.	缺少鉴权信息。
401	ApiKey.Invalid	The api key is invalid.	API Key 无效。
500	Server.InternalError	General Internal Error	服务内部错误。

表中为接口请求错误。异步任务已接收后的执行失败，应以 Poll 的 metadata.task_status、business_code 和 error_msg 为准。

AI 数据湖服务