视频智能包装算子为已剪好的竖屏视频补齐字幕、重点表达、配乐和视觉包装，并交付完整成片、无字幕版、SRT 与包装方案。 # 算子介绍 > 算子 ID：`las_video_packaging` ## 适用场景 |场景 |描述 | |---|---| |产品口播 |识别或导入字幕，增加关键词高亮、信息卡、配乐与音效。 | |营销素材 |为多段竖屏视频统一包装风格、转场与节奏。 | |生活服务与纪实内容 |保留原声并自动规划字幕特效、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 产品不会产生费用。开通操作请参见[准备工作](https://docs.volcengine.com/docs/6492/1264537)。

* 开通完成后可查看算子介绍文档，了解算子能力、上手引导等，详情可参见：[LAS 智能数据处理算子](https://docs.volcengine.com/docs/6492/1798368)。 | |费用 |调用算子前，您需先了解使用算子时的模型调用费用，详情请参见[大模型调用计费](https://www.volcengine.com/docs/6492/1544808)。 | |鉴权（API Key） |调用算子前，您需要先生成算子调用的API Key，并建议将API Key配置为环境变量，便于更安全地调用算子，详情请参见[获取 API Key 并配置](https://docs.volcengine.com/docs/6492/2191994)。 | |BaseURL |调用算子前，您需要先根据您当前使用的LAS服务所在地域，了解算子调用的BaseURL，用于配置算子调用路径参数取值。

详情请参见[获取 Base URL](https://docs.volcengine.com/docs/6492/2191993)，下文中的调用示例仅作为参考，实际调用时需替换为您对应地域的路径取值。 | # 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 错误说明，成功时为空。 ### 示例 ```bash 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_packaging","operator_version":"v1","data":{"video_urls":[{"url":"tos://your-bucket/edited.mp4","script":"欢迎了解本期产品"}],"visual_understanding":false,"output_tos_path":"tos://your-bucket/results/"}}' ``` 多视频字幕来源与包装开关示例： ```json { "operator_id": "las_video_packaging", "operator_version": "v1", "data": { "video_urls": [ { "url": "tos://your-bucket/input/opening.mp4", "subtitle_srt": "tos://your-bucket/input/opening.srt" }, { "url": "tos://your-bucket/input/product.mp4", "script": "这款产品轻巧便携，适合每天随身使用。", "transition_in": "feature_soft_reveal" } ], "smart_packaging": { "enable_sound_effect": false, "bgm_segmentation": "single" }, "instruction": "字幕简洁，突出轻巧便携，不要过于密集。", "subtitle_style": { "font_size": 48, "text_color": "#FFFFFF" }, "output_tos_path": "tos://your-bucket/output/packaging/" } } ``` Submit 成功返回示例： ```json { "metadata": { "task_id": "task-example", "task_status": "PENDING", "business_code": "0", "error_msg": "" } } ``` ### 错误码 |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 的临时下载链接。请求示例： ```bash 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_packaging","operator_version":"v1","task_id":"task-example"}' ``` 成功返回示例： ```json { "metadata": { "task_id": "task-example", "task_status": "COMPLETED", "business_code": "0", "error_msg": "" }, "data": { "clazz": "las_video_packaging", "source_duration_sec": 30.0, "duration_sec": 30.0, "video_count": 1, "subtitle_srt": "1\n00:00:00,000 --> 00:00:02,000\n展示新品细节。\n\n2\n00:00:02,000 --> 00:00:04,000\n了解核心卖点。\n", "summary": { "subtitle_sources": ["srt"], "subtitle_cue_count": 2, "subtitle_effect_count": 0, "keyword_highlight_count": 1, "sound_effect_count": 0, "bgm_track_count": 1, "transition_count": 0, "info_card_count": 0 }, "warnings": [], "usage": { "version": "v1", "asr_duration_ms": 0, "visual_understanding_duration_ms": 0, "output_duration_ms": 30000 }, "artifacts": { "video_subtitled_tos_path": "tos://your-bucket/packaging/results/subtitled.mp4", "video_clean_tos_path": "tos://your-bucket/packaging/results/clean.mp4", "subtitle_srt_tos_path": "tos://your-bucket/packaging/results/subtitle.srt", "packaging_scheme_tos_path": "tos://your-bucket/packaging/results/packaging_scheme.json", "result_json_tos_path": "tos://your-bucket/packaging/results/result.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 数据湖服务