VideoDB icon

VideoDB

Interact with the VideoDB API

Compile Timeline (VideoDB's Video Editor)

AI-generated

Summary

Compile a video timeline by assembling inline videos, overlay images, overlay audio tracks, and overlay text into a multi-track multimedia timeline, and request a stream or player URL for the composed result.

Inputs

  • Inline Videos — Add one or more inline videos by their Asset IDs, specifying optional start and end times (seconds) for each. Leaving an end time of 0 uses the full video length.
  • Overlay Images — Add overlay images with Asset IDs, specifying when each overlay starts (seconds), and optional visual properties including duration, width, height, and X/Y position offsets.
  • Overlay Audio — Add one or more audio overlays by Asset ID with optional start and end times (seconds), fade in/out durations (up to 5s), option to mute other audio tracks while playing, and overlay start time (seconds).
  • Overlay Text — Add overlay text with required text content and overlay start time (seconds). Optionally specify an Asset ID or let the node generate one. Style overrides can be configured including visual attributes such as font, color, size, positioning, and box styling.

Output shape

a single JSON object containing a 'request_type' set to 'compile' and a 'timeline' array describing the composed tracks and overlays

The output JSON object can be used as the timeline definition for further processing or streaming.

Examples

Example 1: Create a video with sequential clips and overlay an image at 5 seconds, and add background audio starting at 0 seconds

Specify multiple inline videos with asset IDs and time ranges, overlay image with start time and dimensions, and one overlay audio track with fade settings and mute flag.

Links

Discussion