HyperVideo 视频生成算子支持通过自然语言描述视频创作需求，并结合图片、音频、视频参考素材，完成视频结构规划、内容生成、渲染、混音和编码，输出可访问的视频 URL 与 TOS 对象路径。 # 算子介绍 > 算子 ID：las_video_hypervideo ## 核心能力 * 视频内容规划与多模态素材引用： * 支持通过自然语言 `prompt` 描述视频主题、风格、字幕和画面文案等创作需求，由算子规划视频结构并生成可渲染内容。 * 支持传入图片、音频和视频参考素材，并在 Prompt 中通过 `@图像N`、`@音频N`、`@视频N` 精确引用。素材编号与数组顺序一一对应。 * 视频规格控制： * 支持通过 `render_config` 设置目标时长、帧率、画面比例和分辨率。 * 口播、背景音乐与音频响应画面： * 支持通过 TTS 音色与口播文案生成口播音轨，也可传入 HTTP(S) BGM。 * 支持根据 TTS 口播、BGM 或参考音频的节奏驱动画面变化。 * 视频渲染与结果交付： * 算子完成视频内容生成后，会继续执行渲染、混音和编码，最终返回视频可访问 URL 与 TOS 对象路径。 * 支持指定 `tos://` 输出路径；未配置存储参数时，使用服务端默认 TOS 目录。 ## 效果展示 * 输入提示词 > 语文课\-古诗中的月亮意象。对比不同诗人笔下的月亮，理解借景抒情与文化意象。 * 生成视频 [video](https://lf3-static.bytednsdoc.com/obj/eden-cn/fgeh7lpauhz/1f101159-9ae6-4f37-ac71-019fed94f2de.mp4) ## 适用场景 |场景类型 |场景说明 | |---|---| |营销短视频 |快速生成产品功能讲解、卖点介绍、竖屏信息流广告等视频。 | |多模态素材成片 |结合已有商品图、品牌音乐或实拍视频，生成风格统一的成片。 | |讲解类视频 |生成古诗讲解、知识科普等带口播、字幕和画面文案的视频。 | |音频响应视频 |根据背景音乐、参考音频或 TTS 口播节奏驱动画面变化。 | ## 支持的地域 * 北京：cn\-beijing * 上海：cn\-shanghai * 广州：cn\-guangzhou ## 算子性能 |细分项 |性能影响说明 | |---|---| |最大 Submit RPM |30 | |最大 Poll RPM |600 | |处理耗时 |视频生成、渲染、混音、编码和上传需要一定时间，耗时会受到目标时长、参考素材数量和渲染规格影响。建议采用退避策略轮询任务状态。 | # 输入与输出要求 ## 输入要求 |细分项 |详细要求 | |---|---| |支持的输入数据模态 |* 文本（用于描述视频主题、风格、字幕和画面文案等需求）

* 图片、音频、视频（生视频的参考图/音频/视频） | |输入格式：图片、音频、视频 |* 格式：图片、音频和视频须能被渲染端按对应媒体类型解码。

* 大小时长：当前未设置统一单文件大小或参考音视频源时长上限，但下载、解码和渲染仍受执行超时及资源限制。参考音频每路从成片 0 秒开始，最多播放到成片结束；参考视频默认静音。输出目标时长的 300 秒上限不适用于参考素材。 | |输入路径要求 |通过请求参数 `reference_images`、`reference_audios`、`reference_videos` 提供图片、音频和视频参考素材，当前仅支持可直接访问的 HTTP(S) URL。

* 素材 URL 无需额外鉴权即可访问；使用预签名链接时，须保持有效直至任务完成。

* 不支持 `tos://`、本地文件路径或 Base64 Data URL。 | ## 输出要求 |细分项 |详细要求 | |---|---| |支持的输出数据模态 |视频 | |输出路径 |可通过 `storage.output_uri` 指定 `tos://` 路径；未配置时会为您生成可直接下载最终结果视频的预签名链接。 | |输出链接有效期 |预签名链接默认有效期为 7 天（604800 秒）；使用临时凭证时可能提前到期。启用 Poll 链接重签的环境会在查询成功结果时生成有效期为 11 小时（39600 秒）的链接，实际有效期以链接中的 `X-Tos-Date` 和 `X-Tos-Expires` 为准。 | # 计费说明 * 计费标准 |细分项 |计费标准说明 | |---|---| |计费项 |按输出的视频的时长统计用量进行计费。 | |计费类型 |按量计费，单位：`元/秒`，按实际的计费用量每小时出账。计费精度：毫秒级精度，去尾 | |单价 |0.5 元/秒 | * 计费详情计费公式：`总费用 = 单价 * 用量` # 注意与前提 |细分项 |注意与前提 | |---|---| |开通 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 调用 ## Submit ### 接口说明提交 HyperVideo 视频生成异步任务。成功后返回任务 ID，可通过 Poll 查询视频结果。线上默认 Submit 限额为 30 RPM，Poll 限额为 600 RPM，实际配额以账号的服务配置为准。参考素材要求如下。 |素材 |格式要求 |大小限制 |源素材时长限制 | |---|---|---|---| |图片 |文件须能被渲染端作为图片解码；当前未设置统一扩展名白名单 |当前未设置统一单文件大小上限 |不适用 | |音频（含 BGM） |文件须能被渲染端作为音频解码；当前未设置统一扩展名白名单 |当前未设置统一单文件大小上限 |当前未设置统一源音频时长上限；参考音轨最多播放到成片结束 | |视频 |文件须能被渲染端作为视频解码；当前未设置统一扩展名白名单 |当前未设置统一单文件大小上限 |当前未设置统一源视频时长上限；输出目标时长的 300 秒上限不适用于参考视频 | 素材 URL 必须能被执行与渲染服务直接访问，无需额外的鉴权请求头；不支持 `tos://`、本地文件路径或 Base64 Data URL。使用预签名链接时，须保持有效直至任务完成。下载、解码和渲染仍受执行超时及资源限制，素材过大或无法解码可能导致任务失败。 ### 请求参数 **operator_id** string 必选 `示例值: las_video_hypervideo` 算子 ID，固定为 `las_video_hypervideo`。 **operator_version** string 必选 `示例值: v1` 算子版本，固定为 `v1`。 **data** VideoHypervideoUserReqParams 必选视频生成业务参数。所有嵌套对象开启严格校验，禁止传入未定义字段。 **prompt** string 必选 `示例值: 参考@图像1生成一个 10 秒产品功能讲解视频` 视频生成需求；风格、字幕、画面文案等建议都写在这里。 **reference_images** array of string `Optional` `示例值: ["https://example.com/images/product.png"]` 参考图片 HTTP(S) URL 列表，默认空数组；数组顺序对应 `@图像1`、`@图像2`，不得重排。文件须为可解码的图片；当前未设置统一格式白名单或单文件大小上限。 **reference_audios** array of string `Optional` `示例值: ["https://example.com/audio/music.mp3"]` 参考音频 HTTP(S) URL 列表，默认空数组；数组顺序对应 `@音频1`、`@音频2`。每项作为独立音轨从成片 0 秒开始，最多播放到成片结束。当前未设置统一格式白名单、单文件大小或源音频时长上限。 **reference_videos** array of string `Optional` `示例值: ["https://example.com/videos/camera.mp4"]` 参考视频 HTTP(S) URL 列表，默认空数组；数组顺序对应 `@视频1`、`@视频2`，默认作为静音视觉素材。文件须为可解码的视频；当前未设置统一格式白名单、单文件大小或源视频时长上限。300 秒限制针对输出目标时长，不是参考视频时长。 **render_config** RenderConfig 必选渲染规格配置；无特殊需求可传空对象 `{}`。 **duration** integer `Optional` `示例值: 10` 目标视频时长，单位秒，取值为整数 1～300（含边界），默认 10；单次任务最多可请求 300 秒（5 分钟）的目标时长。0 或超出范围会返回 `Parameter.Invalid`。实际成片时长以 Poll 返回的 `output_video_duration_sec` 为准。 **fps** integer `Optional` `示例值: 30` 目标帧率，范围 1～60，默认 30。 **ratio** string `Optional` `示例值: 16:9` 画面比例，支持 `16:9`、`9:16`、`1:1`、`4:3`、`3:4`，默认 `16:9`。 **resolution** string `Optional` `示例值: 1080p` 分辨率，支持 `720p`、`1080p`，默认 `1080p`。 **storage** Storage `Optional` 输出存储配置；不传时使用服务端默认 TOS 目录。 **output_uri** string `Optional` `示例值: tos://example-bucket/hypervideo/demo-001` 最终视频输出路径，必须以 `tos://` 开头。 **region** string `Optional` `示例值: cn-beijing` TOS 区域。 **tos_endpoint** string `Optional` `示例值: https://tos-cn-beijing.volces.com` TOS Endpoint。 **audio** Audio `Optional` 音频配置。 **tts_voice** string `Optional` `示例值: zh_female_vv_uranus_bigtts` TTS 口播音色；传入后生成口播音轨。 **narration_text** string `Optional` `示例值: 今天我们一起学习李白的静夜思。` 口播文案；传入时必须同时提供 `tts_voice`。 **bgm_urls** array of string `Optional` `示例值: ["https://example.com/bgm/quiet-night.mp3"]` BGM 地址列表，仅接受可直接访问的 HTTP(S) 音频 URL。格式、大小与链接有效期要求同参考音频。 **audio_reactive** boolean `Optional` `示例值: true` 是否让画面跟随音频节奏；为 `true` 时必须提供 TTS 音色、BGM 或参考音频。 **callback** object `Optional` 任务终态回调配置，`callback.url` 为回调地址；不传时通过 Poll 获取结果。 **idempotent_id** string `Optional` `示例值: hypervideo-demo-001` 幂等 ID，协议预留字段。 ### 返回数据 **metadata** Metadata 请求元信息。 **task_id** string `示例值: fad4efcfd5022e012a3b` 异步任务 ID，用于 Poll 查询。 **task_status** string `示例值: PENDING` 任务状态，提交成功通常为 `PENDING`。 **business_code** string `示例值: 0` 业务码，`0` 表示成功。 **error_msg** string 错误描述，成功时为空。 **request_id** string `示例值: 9fed0e5f0659b128bad47e971aed3c81` 请求 ID，用于问题排查。 ### 请求示例 ```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_hypervideo", "operator_version": "v1", "data": { "prompt": "参考@图像1和@视频1生成一个 10 秒产品功能讲解视频，画面跟随@音频1。", "reference_images": ["https://example.com/images/product.png"], "reference_audios": ["https://example.com/audio/music.mp3"], "reference_videos": ["https://example.com/videos/camera.mp4"], "render_config": { "duration": 10, "fps": 30, "ratio": "16:9", "resolution": "1080p" }, "audio": {"audio_reactive": true} } }' ``` ### 返回示例 ```json { "metadata": { "task_id": "fad4efcfd5022e012a3b", "task_status": "PENDING", "business_code": "0", "error_msg": "" } } ``` ### 错误码 |HttpStatusCode |错误码 |错误信息 |描述 | |---|---|---|---| |400 |Parameter.Invalid |The parameter is invalid. |参数缺失、参考素材或 BGM 非 HTTP(S)、枚举非法、数值越界、`output_uri` 非 `tos://`、`narration_text` 缺少 `tts_voice`、`audio_reactive` 缺少音源或传入未知字段 | |400 |Operator.InvalidId |The operator is invalid. |算子 ID 非法或未注册 | |400 |Operator.InvalidVersion |The operator version is invalid. |算子版本非法 | |401 |Authorization.Missing |The authorization header is missing. |缺少鉴权信息 | |401 |ApiKey.Invalid |The api key is invalid. |API Key 无效 | |429 |Server.Busy |Server is Busy, please try again later. |服务繁忙或限流 | |500 |Server.InternalError |General Internal Error |服务端内部错误 | ## Poll ### 接口说明通过任务 ID 查询任务状态和结果。任务完成后返回视频 URL、TOS 对象路径与输出视频时长。线上默认 Poll 限额为 600 RPM，实际配额以账号的服务配置为准。输出预签名链接的默认有效期为 7 天（604800 秒），从链接签发时起算；使用临时凭证时，实际有效期还受凭证剩余有效期限制。启用 Poll 链接重签的环境会在查询成功结果时生成有效期为 11 小时（39600 秒）的链接，以实际返回链接的 `X-Tos-Date` 和 `X-Tos-Expires` 为准。链接过期后，可基于 `output_video_tos_uri` 重新生成可访问链接；启用重签时也可再次 Poll 刷新链接。默认服务目录中的视频对象保留 30 天；自定义 `storage.output_uri` 时由目标桶的生命周期规则决定。链接到期不代表对象立即删除，建议及时下载保存成片。 ### 请求参数 |名称 |类型 |是否必选 |示例值 |描述 | |---|---|---|---|---| |operator_id |string |是 |las_video_hypervideo |算子 ID | |operator_version |string |是 |v1 |算子版本 | |task_id |string |是 |fad4efcfd5022e012a3b |Submit 返回的异步任务 ID | ### 返回数据 **metadata** Metadata 请求元信息与任务状态。 **task_id** string `示例值: fad4efcfd5022e012a3b` 异步任务 ID。 **task_status** string `示例值: COMPLETED` 任务状态，可取 `PENDING`、`RUNNING`、`COMPLETED`、`FAILED`、`TIMEOUT`、`UNKNOWN`。 **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 `示例值: 0` 业务码。 **error_msg** string 错误或状态描述。 **request_id** string `示例值: 9fed0e5f0659b128bad47e971aed3c81` 请求 ID，用于问题排查。 **data** VideoHypervideoUserResp 任务完成后的视频生成结果，仅任务成功时非空。 **output_video_url** string `示例值: https://example.com/video.mp4` 最终视频可访问 URL。预签名链接默认有效期为 7 天；使用临时凭证时可能提前到期；启用 Poll 链接重签时为 11 小时。详细规则见接口说明。 **output_video_tos_uri** string `示例值: tos://example-bucket/hypervideo/demo-001/video.mp4` 最终视频在 TOS 上的对象路径。 **output_video_duration_sec** double `示例值: 8` 实际输出视频时长，单位秒，用于视频时长计费；不保证与请求的目标时长完全一致。 ### 请求示例 ```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_hypervideo", "operator_version": "v1", "task_id": "fad4efcfd5022e012a3b" }' ``` ### 返回示例 ```json { "metadata": { "task_id": "fad4efcfd5022e012a3b", "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": "" }, "data": { "output_video_url": "https://example.com/video.mp4", "output_video_tos_uri": "tos://example-bucket/hypervideo/demo-001/video.mp4", "output_video_duration_sec": 8 } } ``` 任务级失败（例如下游 Render Server 渲染或上传失败）会以 `metadata.task_status=FAILED` 返回，具体原因通过 `business_code` 和 `error_msg` 提供。 ### 错误码 |HttpStatusCode |错误码 |错误信息 |描述 | |---|---|---|---| |400 |TaskId.Invalid |The task id is invalid. |任务 ID 为空、不存在或结果不存在 | |400 |Parameter.Invalid |The parameter is invalid. |参数校验失败或任务结果解析失败 | |401 |Authorization.Missing |The authorization header is missing. |缺少鉴权信息 | |401 |ApiKey.Invalid |The api key is invalid. |API Key 无效 | |429 |Server.Busy |Server is Busy, please try again later. |服务繁忙或限流 | |500 |Server.InternalError |General Internal Error |服务端内部错误 |

AI 数据湖服务