# 面向 AI 应用与自动化的 JSON to Video 指南

这页文档面向想把 `JSON to video` 接进产品里的开发者。

如果你想先理解这个概念本身，建议先看博客文章 [JSON to Video 是什么？如何把 JSON 变成可渲染的视频](https://renderingvideo.com/zh/blog/json-to-video-guide)。这页更偏实现和工作流。

## 最适合的使用场景

这页文档尤其适合下面这些方向：

- 基于结构化数据生成产品与营销视频
- 构建社媒与短视频自动化生产流
- 基于 CRM 或用户数据生成个性化视频
- 让 Agent 在 AI 应用中自动生成视频
- 搭建带预览、渲染和结果交付的可重复视频系统

## 在产品里，JSON to video 具体意味着什么

对产品团队来说，`JSON to video` 通常意味着：

- 视频由结构化数据定义
- 这些数据可以来自代码、用户输入或 AI
- 渲染系统会校验 Schema 和素材引用
- 系统能完成预览、正式渲染和结果交付

也就是说，JSON 不是一个附带的导出格式，而是应用和渲染管线之间的接口。

## 什么情况下适合用 JSON to video

如果你符合下面这些情况，就很适合考虑 `JSON to video`：

- 视频输出本身就是从结构化数据生成的
- 同一个模板逻辑要生成很多变体
- 产品、Agent 或自动化系统需要触发视频生成
- 希望先预览再正式输出
- 需要异步任务、状态查询和回调

如果你的流程主要是一个人手工做一个视频，编辑器可能更简单；如果你的流程强调可重复、可集成、可自动化，那 JSON 往往是更好的控制面。

## 推荐工作流

更稳妥的流程通常是：

1. 生成或组装视频 Schema
2. 校验结构和素材引用
3. 创建预览
4. 根据预览结果继续调整
5. 启动正式渲染任务
6. 轮询任务状态或接收 Webhook
7. 存储或分发最终视频资源

RenderingVideo 把预览和正式渲染拆开，也是出于这个考虑。对产品工作流来说，这比把每个草稿都直接送去正式渲染更高效，也更安全。

## 接入时的实现清单

如果你要把 `JSON to video API` 接进产品，最低限度通常要处理这些事：

- 定义好产品要生成的 Schema 结构
- 决定素材是上传还是直接引用 URL
- 在发起渲染前先校验必要字段
- 给用户或系统提供预览步骤
- 保存 task ID 和状态变化
- 处理失败任务和重试
- 通过轮询或 Webhook 交付最终结果
- 把可复用模板和运行时数据分开

这也是 demo 级接入和生产级接入的区别所在。

## 一个可用的 Schema 应该覆盖什么

如果你要做的是产品级 JSON to video，而不是演示级配置，Schema 一般至少要覆盖：

- `meta`：画布和视频元信息
- `assets`：图片、视频、音频、字体等素材
- `tracks`：时间线结构
- `clips`：文本、媒体、图形、字幕、布局等内容块
- 动画和时序规则
- 输出和任务生命周期信息

字段级别的详细规则可以继续看 [JSON 结构与字段规范](https://renderingvideo.com/docs/json-spec.md)。


## 预览、渲染和交付

很多 `JSON to video` 的文章只停留在 Schema 示例，但真正做产品集成时，重点在完整链路：

- 预览：快速检查布局、文案和素材
- 渲染：生成最终输出视频
- 交付：通过轮询、任务查询或 Webhook 拿到结果

如果你要看接口级别的调用方式，可以继续看 [API 与使用方式](https://renderingvideo.com/docs/api-and-usage.md)。

## 为什么它特别适合 AI 应用和自动化

当视频生成只是一次性导出时，普通工具就够了。但当视频需要嵌入更大的产品工作流里，JSON 的价值会明显放大。AI 应用可以先生成 Schema 草稿，自动化系统可以注入结构化数据，而你的后端则用预览、正式渲染任务和 Webhook 控制整个交付过程。

这也是为什么 `JSON to video` 越来越像一层基础设施问题，而不只是内容制作技巧。

## 建议继续看的页面

把这页当成入口，接下来可以按问题继续往下看：

- 看 Schema 细节：[JSON 结构与字段规范](https://renderingvideo.com/docs/json-spec.md)
- 看运行流程：[API 与使用方式](https://renderingvideo.com/docs/api-and-usage.md)
- 看可复制 payload：[示例](https://renderingvideo.com/docs/examples.md)
- 看从零开始的步骤：[教程](https://renderingvideo.com/docs/tutorials.md)

如果你现在还在判断概念本身，可以先看配套博客文章 [JSON to Video 是什么？如何把 JSON 变成可渲染的视频](https://renderingvideo.com/zh/blog/json-to-video-guide)。

## 下一步看什么

- 阅读 [JSON 结构与字段规范](https://renderingvideo.com/docs/json-spec.md)
- 查看可复用的 [示例](https://renderingvideo.com/docs/examples.md)
- 跟着 [教程](https://renderingvideo.com/docs/tutorials.md) 走一遍
- 去 [Playground](https://renderingvideo.com/zh/playground) 试工作流
- 去 [开发者页面](https://renderingvideo.com/zh/developers) 看集成入口