> For the complete documentation index, see [llms.txt](https://doc.duaer.com/zh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/zh/build/duaer-video-render.md).

# 用 Duaer Video Render 把 HTML 渲染成视频

在 Duaer 里，Duaer Video Render 把一段 HyperFrames HTML 动画渲染成 MP4，适合字幕、图文卡片、产品介绍这类按脚本排版的视频。
## 渲染一段视频

1. 在节点面板搜索 Duaer Video Render，接到上一个节点后面。
2. HTML Source 选 Text 直接粘贴 HTML；选 Binary File 则从上一步的二进制字段读取（Input Binary Field，默认 data）。
3. 确认 HTML 的根元素带 data-composition-id 和 data-duration（秒，最长 180）。
4. Resolution 选 Match Composition（按根元素的 data-width 和 data-height，没写就用横版）、横版 1920×1080、竖版 1080×1920 或方形 1080×1080。
5. 点执行此步骤。Duaer Video Render 会等到渲染完成，最长 40 分钟。二进制字段 data 是 MP4，另有 renderId、duration（秒）和 credits。

```
<div data-composition-id="intro" data-duration="12" data-width="1080" data-height="1920">
```

HTML 最大 2 MB。写了 data-width 和 data-height 时，比例必须是 16:9、9:16 或 1:1，并且和 Resolution 选的画幅一致，否则 Duaer Video Render 会报错。

## 给 Duaer Video Render 带上素材

Asset Binary Fields 填要一起上传的二进制字段，用逗号分隔，最多 16 个文件，合计不超过 10 MB。每个文件在 HTML 里按 assets/<字段名>.<扩展名> 引用，例如 voice 字段里的 MP3 就是 assets/voice.mp3。支持音频、图片和视频文件。

常见做法：先用 [Duaer Speech](/zh/build/duaer-speech.md) 生成旁白放在 voice 字段，再把它的 duration 写进 data-duration。

## Duaer Video Render 的费用

1080p 下每秒 1 AI 积分，至少 1，计入工作流所有者的积分；渲染失败自动退回。积分额度见 [Duaer 套餐与积分](/zh/manage-cloud/plans.md)。

渲染好的镜头保留 3 小时，这段时间内可以交给 [Duaer Video Concat](/zh/build/duaer-video-concat.md) 拼接，或交给 [Duaer Video Music](/zh/build/duaer-video-music.md) 配乐。
## Questions

### Duaer Video Render 渲染失败会扣积分吗？

不会。在 Duaer 里，渲染失败的积分会自动退回，报错信息会注明。

### Duaer Video Render 报画面比例不支持？

根元素的 data-width 和 data-height 不是 16:9、9:16 或 1:1。改成这三种比例之一，或者去掉这两个属性，在 Resolution 里直接选画幅。

## 相关

- [用 Duaer Video Concat 拼接视频](https://doc.duaer.com/zh/build/duaer-video-concat.md)
- [用 Duaer Video Music 给视频配背景音乐](https://doc.duaer.com/zh/build/duaer-video-music.md)
- [用 Duaer Speech 把文字转成语音](https://doc.duaer.com/zh/build/duaer-speech.md)