AI 数据湖服务
AI 数据湖服务
算子广场
请输入
- 文档首页
AI 数据湖服务视频视频生成HyperFrames 视频生成
复制全文
下载 pdfHyperFrames 视频生成
文档反馈
问问助手HyperFrames 视频生成算子支持通过自然语言描述视频创作需求，并结合图片、音频、视频参考素材，完成视频结构规划、内容生成、渲染、混音和编码，输出可访问的视频 URL 与 TOS 对象路径。
算子介绍
算子 ID：las_video_hypervideo
核心能力
- 视频内容规划与多模态素材引用：
- 支持通过自然语言 prompt 描述视频主题、风格、字幕和画面文案等创作需求，由算子规划视频结构并生成可渲染内容。
- 支持传入图片、音频和视频参考素材，并在 Prompt 中通过 @图像N、@音频N、@视频N 精确引用。素材编号与数组顺序一一对应。
- 视频规格控制：
- 支持通过 render_config 设置目标时长、帧率、画面比例和分辨率。
- 口播、背景音乐与音频响应画面：
- 支持通过 TTS 音色与口播文案生成口播音轨，也可传入 HTTP(S) BGM。
- 支持根据 TTS 口播、BGM 或参考音频的节奏驱动画面变化。
- 视频渲染与结果交付：
- 算子完成视频内容生成后，会继续执行渲染、混音和编码，最终返回视频可访问 URL 与 TOS 对象路径。
- 支持指定 tos:// 输出路径；未配置存储参数时，使用服务端默认 TOS 目录。
效果展示
- 输入提示词
语文课-古诗中的月亮意象。对比不同诗人笔下的月亮，理解借景抒情与文化意象。
- 生成视频
-
Replay Play00:00 / 00:00 Live 00:00FullscreenCssfullscreenClick and hold to drag
适用场景
场景类型 | 场景说明 |
营销短视频 | 快速生成产品功能讲解、卖点介绍、竖屏信息流广告等视频。 |
多模态素材成片 | 结合已有商品图、品牌音乐或实拍视频，生成风格统一的成片。 |
讲解类视频 | 生成古诗讲解、知识科普等带口播、字幕和画面文案的视频。 |
音频响应视频 | 根据背景音乐、参考音频或 TTS 口播节奏驱动画面变化。 |
支持的地域
- 北京：cn-beijing
- 上海：cn-shanghai
- 广州：cn-guangzhou
算子性能
细分项 | 性能影响说明 |
最大 Submit RPM | 30 |
最大 Poll RPM | 600 |
处理耗时 | 视频生成、渲染、混音、编码和上传需要一定时间，耗时会受到目标时长、参考素材数量和渲染规格影响。建议采用退避策略轮询任务状态。 |
输入与输出要求
输入要求
细分项 | 详细要求 |
支持的输入数据模态 |
|
输入格式：图片、音频、视频 |
|
输入路径要求 | 通过请求参数 reference_images、reference_audios、reference_videos 提供图片、音频和视频参考素材，当前仅支持可直接访问的 HTTP(S) URL。
|
输出要求
细分项 | 详细要求 |
支持的输出数据模态 | 视频 |
输出路径 | 可通过 storage.output_uri 指定 tos:// 路径；未配置时会为您生成可直接下载最终结果视频的预签名链接。 |
输出链接有效期 | 预签名链接默认有效期为 7 天（604800 秒）；使用临时凭证时可能提前到期。启用 Poll 链接重签的环境会在查询成功结果时生成有效期为 11 小时（39600 秒）的链接，实际有效期以链接中的 X-Tos-Date 和 X-Tos-Expires 为准。 |
计费说明
- 计费标准
-
- 细分项计费标准说明计费项按输出的视频的时长统计用量进行计费。计费类型按量计费，单位：元/秒，按实际的计费用量每小时出账。计费精度：毫秒级精度，去尾单价0.5 元/秒
- 计费详情
- 计费公式：总费用 = 单价 * 用量
注意与前提
Rest API 调用
Submit
接口说明
提交 HyperFrames 视频生成异步任务。成功后返回任务 ID，可通过 Poll 查询视频结果。
线上默认 Submit 限额为 30 RPM，Poll 限额为 600 RPM，实际配额以账号的服务配置为准。
参考素材要求如下。
素材 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，用于问题排查。
请求示例
返回示例
错误码
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 时由目标桶的生命周期规则决定。链接到期不代表对象立即删除，建议及时下载保存成片。
请求参数
返回数据
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
实际输出视频时长，单位秒，用于视频时长计费；不保证与请求的目标时长完全一致。
请求示例
返回示例
任务级失败（例如下游 Render Server 渲染或上传失败）会以 metadata.task_status=FAILED 返回，具体原因通过 business_code 和 error_msg 提供。
错误码
最近更新时间：2026.10.21 20:48:58
这个页面对您有帮助吗？
有用
有用
无用
无用