Automotion documentation

Automotion turns a JSON document into a rendered MP4. You describe scenes, text, images, video clips, voiceovers and subtitles in the Automotion Movie Schema; the API renders it and hands you back a video URL.

The document is the whole truth: what you send is exactly what renders — no hidden fields, no server-side mutations, and every validation error points at the exact JSON path that caused it.

Start here

The 30-second mental model

1. Write a movie document — scenes containing elements (text, image, video, audio, voice, subtitles, component).
2. POST it to https://api.automotion.dev/v1/renders with your API key.
3. Poll GET /v1/renders/{id} (or receive a signed webhook) until status is done, then download outputUrl.

{
  "schema": "v1",
  "preset": "9:16",
  "scenes": [
    {
      "id": "hello",
      "duration": 3,
      "background": "#0f172a",
      "elements": [{ "id": "hello-text", "type": "text", "text": "Hello, Automotion!" }]
    }
  ]
}

▶ Try it in the playground

Templates add {{variables}} on top — declare them once, then render the same template with different values per request. AI generation goes one step further: describe the video you want and get a schema-valid document back to edit and render.