RenderingVideo 文档
一份面向开发者的 JSON to Video 实战指南，适合产品视频、社媒短片、个性化视频和 Agent 自动生成工作流。
面向 AI 应用与自动化的 JSON to Video 指南
这页文档面向想把 JSON to video 接进产品里的开发者。
如果你想先理解这个概念本身，建议先看博客文章 JSON to Video 是什么？如何把 JSON 变成可渲染的视频。这页更偏实现和工作流。
最适合的使用场景
这页文档尤其适合下面这些方向：
- 基于结构化数据生成产品与营销视频
- 构建社媒与短视频自动化生产流
- 基于 CRM 或用户数据生成个性化视频
- 让 Agent 在 AI 应用中自动生成视频
- 搭建带预览、渲染和结果交付的可重复视频系统
在产品里，JSON to video 具体意味着什么
对产品团队来说，JSON to video 通常意味着：
- 视频由结构化数据定义
- 这些数据可以来自代码、用户输入或 AI
- 渲染系统会校验 Schema 和素材引用
- 系统能完成预览、正式渲染和结果交付
也就是说，JSON 不是一个附带的导出格式，而是应用和渲染管线之间的接口。
什么情况下适合用 JSON to video
如果你符合下面这些情况，就很适合考虑 JSON to video：
- 视频输出本身就是从结构化数据生成的
- 同一个模板逻辑要生成很多变体
- 产品、Agent 或自动化系统需要触发视频生成
- 希望先预览再正式输出
- 需要异步任务、状态查询和回调
如果你的流程主要是一个人手工做一个视频，编辑器可能更简单；如果你的流程强调可重复、可集成、可自动化，那 JSON 往往是更好的控制面。
推荐工作流
更稳妥的流程通常是：
- 生成或组装视频 Schema
- 校验结构和素材引用
- 创建预览
- 根据预览结果继续调整
- 启动正式渲染任务
- 轮询任务状态或接收 Webhook
- 存储或分发最终视频资源
RenderingVideo 把预览和正式渲染拆开，也是出于这个考虑。对产品工作流来说，这比把每个草稿都直接送去正式渲染更高效，也更安全。
接入时的实现清单
如果你要把 JSON to video API 接进产品，最低限度通常要处理这些事：
- 定义好产品要生成的 Schema 结构
- 决定素材是上传还是直接引用 URL
- 在发起渲染前先校验必要字段
- 给用户或系统提供预览步骤
- 保存 task ID 和状态变化
- 处理失败任务和重试
- 通过轮询或 Webhook 交付最终结果
- 把可复用模板和运行时数据分开
这也是 demo 级接入和生产级接入的区别所在。
一个可用的 Schema 应该覆盖什么
如果你要做的是产品级 JSON to video，而不是演示级配置，Schema 一般至少要覆盖：
meta：画布和视频元信息assets：图片、视频、音频、字体等素材tracks：时间线结构clips：文本、媒体、图形、字幕、布局等内容块- 动画和时序规则
- 输出和任务生命周期信息
字段级别的详细规则可以继续看 JSON 结构与字段规范。
预览、渲染和交付
很多 JSON to video 的文章只停留在 Schema 示例，但真正做产品集成时，重点在完整链路：
- 预览：快速检查布局、文案和素材
- 渲染：生成最终输出视频
- 交付：通过轮询、任务查询或 Webhook 拿到结果
如果你要看接口级别的调用方式，可以继续看 API 与使用方式。
为什么它特别适合 AI 应用和自动化
当视频生成只是一次性导出时，普通工具就够了。但当视频需要嵌入更大的产品工作流里，JSON 的价值会明显放大。AI 应用可以先生成 Schema 草稿，自动化系统可以注入结构化数据，而你的后端则用预览、正式渲染任务和 Webhook 控制整个交付过程。
这也是为什么 JSON to video 越来越像一层基础设施问题，而不只是内容制作技巧。
建议继续看的页面
把这页当成入口，接下来可以按问题继续往下看：
- 看 Schema 细节：JSON 结构与字段规范
- 看运行流程：API 与使用方式
- 看可复制 payload：示例
- 看从零开始的步骤：教程
如果你现在还在判断概念本身，可以先看配套博客文章 JSON to Video 是什么？如何把 JSON 变成可渲染的视频。
下一步看什么
- 阅读 JSON 结构与字段规范
- 查看可复用的 示例
- 跟着 教程 走一遍
- 去 Playground 试工作流
- 去 开发者页面 看集成入口