Video Examples

Each example is a complete POST /v1/renders body. Only fields that differ from their defaults are shown. See the element field reference for every default.

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 how long the clip plays.Every video element below sets out_point for a second reason: for a source_url Framelane does not host, submitting without one is a 422 invalid_source. The dry-run linter cannot see this — it reports ok: true and the real submit still fails. Upload the file, set ingest_external: true, or set out_point yourself.

Minimal video

source_url is the only field the schema requires, and out_point is the only one the submit path adds (see above). Everything else uses defaults (x: "50%", y: "50%", width: "100%", height: "100%", opacity: 100, volume: 100).

{
  "width": 1920,
  "height": 1080,
  "elements": [
    {
      "type": "video",
      "id": "vid1",
      "source_url": "https://cdn.example.com/clip.mp4",
      "out_point": 6
    }
  ]
}

Trim source clip

Play only seconds 2–8 of the source file.

{
  "width": 1920,
  "height": 1080,
  "duration": 6,
  "elements": [
    {
      "type": "video",
      "id": "vid1",
      "source_url": "https://cdn.example.com/clip.mp4",
      "in_point": 2,
      "out_point": 8
    }
  ]
}

Playback speed

Play the clip at 2× speed.

{
  "width": 1920,
  "height": 1080,
  "duration": 6,
  "elements": [
    {
      "type": "video",
      "id": "vid1",
      "source_url": "https://cdn.example.com/clip.mp4",
      "in_point": 0,
      "out_point": 12,
      "speed": 2.0
    }
  ]
}

Speed ramp

Ramp the rate across the clip instead of pinning it. time values are timeline seconds and must be strictly increasing — duplicates or out-of-order entries are a 422. rate: 0 freezes the frame. Max 512 keyframes.

{
  "width": 1920,
  "height": 1080,
  "duration": 10,
  "elements": [
    {
      "type": "video",
      "id": "vid1",
      "source_url": "https://cdn.example.com/clip.mp4",
      "in_point": 0,
      "out_point": 6,
      "volume": 0,
      "playback_rate_keyframes": [
        { "time": 0, "rate": 1 },
        { "time": 2, "rate": 0.25 },
        { "time": 4, "rate": 1.5 }
      ]
    }
  ]
}

Audio does not follow the ramp — it keeps the static speed. Mute the clip (volume: 0, as above) or move the sound to its own audio element.
A ramp that ends at rate: 0 never finishes, so the request must carry an explicit top-level duration or you get a 422.
For an instant step, put the two rates 0.001 s apart.

Audio fade in and out

Fade audio in over 1 second and out over 1 second. fade_in_duration / fade_out_duration affect the embedded audio track only.

{
  "width": 1920,
  "height": 1080,
  "duration": 6,
  "elements": [
    {
      "type": "video",
      "id": "vid1",
      "source_url": "https://cdn.example.com/clip.mp4",
      "in_point": 0,
      "out_point": 6,
      "fade_in_duration": 1,
      "fade_out_duration": 1
    }
  ]
}

Position and size

Place a 50%-wide clip in the bottom-right corner.

{
  "width": 1920,
  "height": 1080,
  "duration": 6,
  "elements": [
    {
      "type": "video",
      "id": "vid1",
      "source_url": "https://cdn.example.com/clip.mp4",
      "in_point": 0,
      "out_point": 6,
      "x": "75%",
      "y": "75%",
      "width": "50%",
      "height": "50%"
    }
  ]
}

3D tilt

x_rotation and y_rotation tilt the plane in perspective; z_rotation is the flat spin. x_anchor / y_anchor choose the pivot — "0%" below swings the clip about its left edge instead of its centre. They move nothing when there is no rotation. Valid on video, image, and shape; a 422 on text.

{
  "width": 1920,
  "height": 1080,
  "duration": 6,
  "elements": [
    {
      "type": "video",
      "id": "vid1",
      "source_url": "https://cdn.example.com/clip.mp4",
      "in_point": 0,
      "out_point": 6,
      "width": "70%",
      "height": "70%",
      "x_rotation": "8°",
      "y_rotation": "-18°",
      "z_rotation": "2°",
      "x_anchor": "0%"
    }
  ]
}

Blend modes and track mattes

blend_mode accepts all 17 renderer modes, including the non-separable hue / saturation / color / luminosity set. matte clips this element to another layer’s luma or alpha; the layer named in source is hidden automatically by the engine — it only supplies the shape.

{
  "width": 1920,
  "height": 1080,
  "duration": 6,
  "elements": [
    {
      "type": "shape",
      "id": "mask1",
      "duration": 6,
      "path": "M50 5 L95 95 L5 95 Z",
      "fill": "#ffffff"
    },
    {
      "type": "video",
      "id": "vid1",
      "source_url": "https://cdn.example.com/clip.mp4",
      "out_point": 6,
      "blend_mode": "soft_light",
      "matte": { "source": "mask1", "mode": "luma", "invert": false }
    }
  ]
}

backdrop_blur (radius in pixels) frosts everything behind the element. blend_mode, matte, and backdrop_blur are available on video, image, and shape only — they are a 422 (Extra inputs are not permitted) on text.

Repeat a short clip

Repeat a 6-second clip twice to fill a 12-second render. Add one element per repeat with a different time and matching in_point/out_point.

{
  "width": 1920,
  "height": 1080,
  "duration": 12,
  "elements": [
    {
      "type": "video",
      "id": "vid1",
      "source_url": "https://cdn.example.com/clip.mp4",
      "time": 0,
      "in_point": 0,
      "out_point": 6
    },
    {
      "type": "video",
      "id": "vid2",
      "source_url": "https://cdn.example.com/clip.mp4",
      "time": 6,
      "in_point": 0,
      "out_point": 6
    }
  ]
}

Get Started

Renders

Render Examples

Recipes

Tasks

Webhooks

SDKs

Minimal video

Trim source clip

Playback speed

Speed ramp

Audio fade in and out

Position and size

3D tilt

Blend modes and track mattes

Repeat a short clip

​Minimal video

​Trim source clip

​Playback speed

​Speed ramp

​Audio fade in and out

​Position and size

​3D tilt

​Blend modes and track mattes

​Repeat a short clip

Minimal video

Trim source clip

Playback speed

Speed ramp

Audio fade in and out

Position and size

3D tilt

Blend modes and track mattes

Repeat a short clip