# 面向 AI 应用与自动化的 JSON to Video 文档

## 阅读顺序

1. [JSON to Video 指南](https://renderingvideo.com/docs/json-to-video.md)
2. [JSON 结构与字段规范](https://renderingvideo.com/docs/json-spec.md)
3. [Clip 与元素文档索引](https://renderingvideo.com/docs/clips.md)
4. [动画、关键帧、转场](https://renderingvideo.com/docs/animation-and-timing.md)
5. [模板系统](https://renderingvideo.com/docs/templates.md)
6. [API 与使用方式](https://renderingvideo.com/docs/api-and-usage.md)
7. [示例](https://renderingvideo.com/docs/examples.md)
8. [教程](https://renderingvideo.com/docs/tutorials.md)

## 解释顺序

1. 实际运行时实现
2. 本文档
3. 类型声明

如果某个字段出现在类型定义中，但当前渲染器并未使用，文档会明确标注该限制。

## 这套文档最适合解决什么问题

这套文档尤其适合下面这些场景：

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

## 核心原则

- 只支持新协议：`meta / assets / tracks`
- 只写当前项目已经实现的能力
- 明确区分“声明存在”和“运行时真的生效”
- 明确列出限制，而不是模糊描述成“理论支持”

## 导航

- 关于面向实现的 JSON to video 总览，参见 [JSON to Video 指南](https://renderingvideo.com/docs/json-to-video.md)
- 关于顶层结构与字段规则，参见 [JSON 结构与字段规范](https://renderingvideo.com/docs/json-spec.md)
- 关于 clip 类型与参考入口，参见 [Clip 与元素文档索引](https://renderingvideo.com/docs/clips.md)
- 关于单个元素的独立参考页，参见 [元素文档目录](https://renderingvideo.com/docs/elements.md)
- 关于动画时序、关键帧与转场，参见 [动画、关键帧、转场](https://renderingvideo.com/docs/animation-and-timing.md)
- 关于模板定义与限制，参见 [模板系统](https://renderingvideo.com/docs/templates.md)
- 关于接口入口与运行流程，参见 [API 与使用方式](https://renderingvideo.com/docs/api-and-usage.md)
- 关于可直接复用的 schema 片段，参见 [示例](https://renderingvideo.com/docs/examples.md)
- 关于按任务组织的实战文档，参见 [教程](https://renderingvideo.com/docs/tutorials.md)