Motion Examples

Motion presets are set via the motion array on video, image, and text elements. Only fields that differ from their defaults are shown (easing defaults to "ease_in_out", reversed defaults to false).

For text and image elements, duration is required — the API returns 422 if it is missing. video and audio elements have no duration field — use out_point to control clip length.

Fade in

Fade the element in over 0.5 seconds at the start. Text is visible from 1 s to 5 s over video. time on the motion object is absolute timeline seconds — the same clock as the element’s own time. Match it to the element’s time for entrances, and set it to element time + duration − motion duration for exits.

{
  "width": 1920,
  "height": 1080,
  "duration": 10,
  "elements": [
    {
      "type": "video",
      "id": "vid1",
      "source_url": "https://cdn.example.com/clip.mp4",
      "time": 0,
      "in_point": 0,
      "out_point": 10
    },
    {
      "type": "text",
      "id": "t1",
      "text": "Hello",
      "font_size": 72,
      "time": 1,
      "duration": 4,
      "x": "50%",
      "y": "50%",
      "motion": [
        { "type": "fade", "time": 1, "duration": 0.5 }
      ]
    }
  ]
}

Fade out (reversed)

Use "reversed": true to play the exit variant of any motion preset. Text visible from 0 s to 6 s; the fade-out runs during the last second of that window.

{
  "width": 1920,
  "height": 1080,
  "duration": 10,
  "elements": [
    {
      "type": "video",
      "id": "vid1",
      "source_url": "https://cdn.example.com/clip.mp4",
      "time": 0,
      "in_point": 0,
      "out_point": 10
    },
    {
      "type": "text",
      "id": "t1",
      "text": "Goodbye",
      "font_size": 72,
      "time": 0,
      "duration": 6,
      "x": "50%",
      "y": "50%",
      "motion": [
        { "type": "fade", "time": 5, "duration": 1, "reversed": true, "easing": "ease_out" }
      ]
    }
  ]
}

Position in (slide)

Text slides in at 2 s, stays for 3 s, anchored on the left side of the frame.

{
  "width": 1920,
  "height": 1080,
  "duration": 10,
  "elements": [
    {
      "type": "video",
      "id": "vid1",
      "source_url": "https://cdn.example.com/clip.mp4",
      "time": 0,
      "in_point": 0,
      "out_point": 10
    },
    {
      "type": "text",
      "id": "t1",
      "text": "SLIDE",
      "font_size": 72,
      "time": 2,
      "duration": 3,
      "x": "20%",
      "y": "50%",
      "motion": [
        { "type": "slide_right", "time": 2, "duration": 0.8 }
      ]
    }
  ]
}

Ken Burns (video / image)

Slow pan and zoom on footage.

{
  "width": 1920,
  "height": 1080,
  "duration": 10,
  "elements": [
    {
      "type": "video",
      "source_url": "https://cdn.example.com/photo.mp4",
      "volume": 0,
      "motion": [
        { "type": "ken_burns_in", "time": 0, "duration": 10 }
      ]
    }
  ]
}

Looping animation

Continuous motion while the element is visible. Text visible from 1 s to 7 s; set the loop preset duration to match the element’s duration.

{
  "width": 1920,
  "height": 1080,
  "duration": 10,
  "elements": [
    {
      "type": "video",
      "id": "vid1",
      "source_url": "https://cdn.example.com/clip.mp4",
      "time": 0,
      "in_point": 0,
      "out_point": 10
    },
    {
      "type": "text",
      "id": "t1",
      "text": "ALERT",
      "font_size": 96,
      "time": 1,
      "duration": 6,
      "x": "50%",
      "y": "30%",
      "text_color": "#ff0000",
      "motion": [
        { "type": "loop_wiggle", "time": 1, "duration": 6 }
      ]
    }
  ]
}

Per-character animation (text only)

Animate each character individually with "scope": "character". Only supported on text elements. Text visible from 0.5 s to 4.5 s. Supported types: fade, slide_up, slide_down, slide_left, slide_right, zoom_in, bounce, bounce_motion, blend.

{
  "width": 1920,
  "height": 1080,
  "duration": 10,
  "elements": [
    {
      "type": "video",
      "id": "vid1",
      "source_url": "https://cdn.example.com/clip.mp4",
      "time": 0,
      "in_point": 0,
      "out_point": 10
    },
    {
      "type": "text",
      "id": "t1",
      "text": "WAVE",
      "font_size": 96,
      "time": 0.5,
      "duration": 4,
      "x": "50%",
      "y": "60%",
      "motion": [
        {
          "type": "bounce",
          "time": 0.5,
          "duration": 1,
          "scope": "character",
          "delay": 0.05
        }
      ]
    }
  ]
}

All motion types

Types marked both have an exit variant — add "reversed": true to play the exit. Types marked exit only set reversed automatically and never need it in the request.

Opacity

`type`	Direction	Description
`fade`	both — `reversed: true` for exit	Fade in / fade out

Position

`type`	Direction	Description
`slide_up`	both — `reversed: true` for exit	Slide in from below / out upward
`slide_down`	both — `reversed: true` for exit	Slide in from above / out downward
`slide_left`	both — `reversed: true` for exit	Slide in from the right / out to the left
`slide_right`	both — `reversed: true` for exit	Slide in from the left / out to the right

Scale & bounce

`type`	Direction	Description
`zoom_in`	entrance only	Scale up into view
`zoom_out`	exit only — auto-reversed	Scale down out of view
`bounce`	both — `reversed: true` for exit	Bouncy scale entrance / exit

Wipe

`type`	Direction	Description
`wipe_left`	both — `reversed: true` for exit	Wipe reveal from right / conceal to left
`wipe_right`	both — `reversed: true` for exit	Wipe reveal from left / conceal to right
`wipe_up`	both — `reversed: true` for exit	Wipe reveal from bottom / conceal upward
`wipe_down`	both — `reversed: true` for exit	Wipe reveal from top / conceal downward

Rotation

`type`	Direction	Description
`rotate_cw`	both — `reversed: true` for exit	Clockwise rotation in / out
`rotate_ccw`	both — `reversed: true` for exit	Counter-clockwise rotation in / out

Ken Burns (video / image only)

`type`	Direction	Description
`ken_burns_in`	entrance only	Slow zoom in
`ken_burns_out`	entrance only	Slow zoom out
`ken_burns_in_out`	entrance only	Zoom in then out

Looping

`type`	Description
`loop_wiggle`	Quick shake — like AE’s `wiggle()` expression
`loop_rotate`	Continuous rotation
`loop_rotate_smooth`	Smooth continuous rotation
`loop_3d_spin`	3D spin
`loop_3d_sway`	3D sway

Get Started

Renders

Render Examples

Recipes

Tasks

Webhooks

SDKs

Fade in

Fade out (reversed)

Position in (slide)

Ken Burns (video / image)

Looping animation

Per-character animation (text only)

All motion types

Opacity

Position

Scale & bounce

Wipe

Rotation

Ken Burns (video / image only)

Looping

​Fade in

​Fade out (reversed)

​Position in (slide)

​Ken Burns (video / image)

​Looping animation

​Per-character animation (text only)

​All motion types

​Opacity

​Position

​Scale & bounce

​Wipe

​Rotation

​Ken Burns (video / image only)

​Looping

Fade in

Fade out (reversed)

Position in (slide)

Ken Burns (video / image)

Looping animation

Per-character animation (text only)

All motion types

Opacity

Position

Scale & bounce

Wipe

Rotation

Ken Burns (video / image only)

Looping