# JSON to Video Docs for AI Apps and Automation

## Recommended reading order

1. [JSON to Video Guide](https://renderingvideo.com/docs/json-to-video.md)
2. [JSON Structure and Field Rules](https://renderingvideo.com/docs/json-spec.md)
3. [Clip and Element Index](https://renderingvideo.com/docs/clips.md)
4. [Animation, Keyframes, and Transitions](https://renderingvideo.com/docs/animation-and-timing.md)
5. [Template System](https://renderingvideo.com/docs/templates.md)
6. [API and Usage](https://renderingvideo.com/docs/api-and-usage.md)
7. [Examples](https://renderingvideo.com/docs/examples.md)
8. [Tutorials](https://renderingvideo.com/docs/tutorials.md)

## Interpretation order

1. Runtime implementation
2. This documentation
3. Type declarations

If a field appears in a type definition but is not used by the current renderer, that limitation is noted explicitly.

## What this documentation helps you build

This documentation is best suited for teams building:

- Product and promo videos from structured data
- Social and short-form content pipelines
- Personalized videos from CRM or user data
- Agent-driven video generation inside AI workflows
- Repeatable video systems that need preview, render, and delivery

## Core principles

- Only the new protocol is documented: `meta / assets / tracks`
- Only currently implemented behavior is documented
- Declared fields and effective runtime fields are treated separately
- Limits are written clearly instead of being implied as "theoretically supported"

## Navigation

- For an implementation-oriented JSON to video overview, see [JSON to Video Guide](https://renderingvideo.com/docs/json-to-video.md)
- For top-level schema structure and field rules, see [JSON Structure and Field Rules](https://renderingvideo.com/docs/json-spec.md)
- For clip types and reference entry points, see [Clip and Element Index](https://renderingvideo.com/docs/clips.md)
- For per-element reference pages, see [Element Reference Index](https://renderingvideo.com/docs/elements.md)
- For animation timing, keyframes, and transitions, see [Animation, Keyframes, and Transitions](https://renderingvideo.com/docs/animation-and-timing.md)
- For template definitions and constraints, see [Template System](https://renderingvideo.com/docs/templates.md)
- For API entry points and runtime usage flow, see [API and Usage](https://renderingvideo.com/docs/api-and-usage.md)
- For copyable schema snippets, see [Examples](https://renderingvideo.com/docs/examples.md)
- For task-oriented walkthroughs, see [Tutorials](https://renderingvideo.com/docs/tutorials.md)