How JsonCut works
Understand the shared project model and choose Studio, API or MCP for the job.
JsonCut keeps the creative source and the exported result separate. The source remains an editable image or video project. A render turns one pinned version of that source into a downloadable artifact.
One project, three ways to work
| Workflow | What you control | Choose it when |
|---|---|---|
| Studio | Canvas, layers, timeline and visual review | A person wants to design, inspect or refine the result directly |
| V2 API | Projects, media, templates, renders and webhooks | Your application needs predictable server-side automation |
| MCP | The same public authoring concepts through focused tools | An Agent should build, review and reuse editable work |
You can start in any column and continue in another. A project created through the API can be opened in Studio. A Studio project can become a typed template. An MCP Agent can edit that same project without flattening it.
The durable workflow
- Create an image or video project.
- Add owned or uploaded media as normal editable layers.
- Review the canvas or timeline and save a version.
- Export the current version, or publish it as a template.
- Reuse the template with controlled values in Studio, API or MCP.
Source, project, template and render
| Term | Meaning |
|---|---|
| Source | The portable jsoncut-html composition with canvas, layers, variables and values |
| Project | A durable source with metadata and immutable version history |
| Template | A published project version with a discoverable typed input contract |
| Render | An asynchronous image or video artifact from a pinned source or template version |
The source contract is public. Internal rendering infrastructure is deliberately not part of it.
Where to continue
- Use Studio overview for visual editing.
- Use the project quickstart for the first API render.
- Use Connect an MCP client for Agent workflows.
- Open the interactive V2 API reference for exact endpoint contracts and the built-in request playground.