Transition Examples

Transitions go in the top-level transitions array. Each transition references video element id values via from_id (outgoing) and to_id (incoming) — transitions are supported between video elements only; any other element type is rejected.

Transitions link visible video elements only — an image, a text element, or a video with visible: false on either side is rejected with a 422.One in, one out per clip. A given video can be the outgoing side of at most one transition and the incoming side of at most one; a second is a 422, because the engine would silently erase the extra.from_id and to_id are each optional: omit from_id to transition in from nothing at the head of the timeline, or to_id to transition out at the tail.

Cross dissolve

Fade between two video clips. The time values create a sequential timeline; the transition overlaps the cut. Each clip carries an explicit in_point/out_point: a source_url Framelane does not host is rejected at submit with 422 invalid_source without one, and the dry run cannot see it.

{
  "width": 1920,
  "height": 1080,
  "duration": 12,
  "elements": [
    {
      "type": "video",
      "id": "clip_a",
      "source_url": "https://cdn.example.com/clip-a.mp4",
      "in_point": 0,
      "out_point": 6,
      "time": 0
    },
    {
      "type": "video",
      "id": "clip_b",
      "source_url": "https://cdn.example.com/clip-b.mp4",
      "in_point": 0,
      "out_point": 6,
      "time": 6
    }
  ],
  "transitions": [
    { "type": "cross_dissolve", "duration": 1.0, "from_id": "clip_a", "to_id": "clip_b" }
  ]
}

Chain more than two clips by pairing them one cut at a time — each clip is the incoming side of one transition and the outgoing side of the next.

{
  "width": 1920,
  "height": 1080,
  "duration": 18,
  "elements": [
    {
      "type": "video",
      "id": "clip_a",
      "source_url": "https://cdn.example.com/clip-a.mp4",
      "in_point": 0,
      "out_point": 6,
      "time": 0
    },
    {
      "type": "video",
      "id": "clip_b",
      "source_url": "https://cdn.example.com/clip-b.mp4",
      "in_point": 0,
      "out_point": 6,
      "time": 6
    },
    {
      "type": "video",
      "id": "clip_c",
      "source_url": "https://cdn.example.com/clip-c.mp4",
      "in_point": 0,
      "out_point": 6,
      "time": 12
    }
  ],
  "transitions": [
    { "type": "cross_dissolve", "duration": 1.0, "from_id": "clip_a", "to_id": "clip_b" },
    { "type": "cross_dissolve", "duration": 1.0, "from_id": "clip_b", "to_id": "clip_c" }
  ]
}

Wipe left

{
  "width": 1920,
  "height": 1080,
  "duration": 12,
  "elements": [
    {
      "type": "video",
      "id": "clip_a",
      "source_url": "https://cdn.example.com/clip-a.mp4",
      "in_point": 0,
      "out_point": 6,
      "time": 0
    },
    {
      "type": "video",
      "id": "clip_b",
      "source_url": "https://cdn.example.com/clip-b.mp4",
      "in_point": 0,
      "out_point": 6,
      "time": 6
    }
  ],
  "transitions": [
    {
      "type": "wipe_left",
      "duration": 0.8,
      "from_id": "clip_a",
      "to_id": "clip_b"
    }
  ]
}

All transition types

All 49 renderer transition shaders are exposed. GET /v1/capabilities carries the same list with per-value descriptions. Editorial staples

`type`	Description
`cross_dissolve`	Standard crossfade (Premiere: Cross Dissolve)
`dip_to_black`	Fade through black (Premiere: Dip to Black)
`dip_to_white`	Fade through white (Premiere: Dip to White)
`wipe_left` / `wipe_right` / `wipe_up` / `wipe_down`	Directional wipes
`diagonal_wipe`	Diagonal wipe
`barn_doors_horizontal` / `barn_doors_vertical`	Barn doors open/close
`iris`	Iris / concentric circle wipe
`page_turn`	Page turn / peel
`cross_zoom`	Zoom dissolve between clips (Premiere: Cross Zoom)
`gradient_wipe`	Gradient-based wipe (Premiere: Gradient Wipe)
`band_wipe`	Band wipe (Premiere: Band Wipe)
`box_wipe`	Box shrink / grow wipe (Premiere: Box Wipe)
`splice`	Angled splice slides the incoming clip over the outgoing
`three_stripes`	Three offset stripes sweep the incoming clip in
`circle_crop`	Both clips crop to a shrinking/growing circle
`circle_open`	Circle-open reveal
`fold_horizontal` / `fold_vertical`	Outgoing clip folds away
`minimise_top_left` / `minimise_top_right` / `minimise_bottom_left` / `minimise_bottom_right`	Outgoing clip shrinks into a corner
`rotate`	Both clips rotate about the frame centre through the cut

Stylized (gl-transitions ports)

`type`	Description
`swirl`	Swirl distortion through the cut
`glitch_memories`	Glitch displacement
`window_slice`	Vertical slice reveal
`cube`	3D cube face rotation
`doorway`	3D doorway opening
`pinwheel`	Pinwheel sweep
`water_drop`	Water-drop ripple
`crosshatch`	Crosshatch dissolve
`dreamy`	Wavy dreamy dissolve
`angular`	Angular sweep
`burn`	Color-burn dissolve
`heart`	Heart-shaped reveal
`color_phase`	Per-channel phase dissolve
`squares_wire`	Wire-grid squares
`cross_warp`	Clips warp into each other along a dissolving threshold
`ripple`	Water-ripple distortion sweeps the cut
`linear_blur`	Cross-dissolve through a heavy directional blur peak

Short-form signatures (W3)

`type`	Description
`whip_pan`	The fast-promo whip: both clips pan with a speed-proportional smear, maximal at the cut
`cinematic_zoom`	Outgoing punches in, incoming settles, with radial blur and chromatic fringing at the cut
`burn_edge`	A noise-ridged burn front sweeps across with an ember band and sparks
`shatter`	Outgoing clip cuts into a jittered grid of shards flying radially outward
`domain_warp`	The outgoing frame liquefies into the incoming along a glowing frontier

Get Started

Renders

Render Examples

Recipes

Tasks

Webhooks

SDKs

Transition Examples

Cross dissolve

Wipe left

All transition types

​Cross dissolve

​Wipe left

​All transition types

Cross dissolve

Wipe left

All transition types