bookoly icon

bookoly

Interact with the bookoly API

Video → Stack Videos

AI-generated

Summary

Combines two video files into a single video stacked either side-by-side horizontally or top-to-bottom vertically.

Inputs

  • name (required) — The name to assign to the generated video.
  • url (required) — The public, downloadable URL of the primary video file.
  • secondary_video_url (required) — The public, downloadable URL of the secondary video file to stack with the primary video.
  • layout (required) — The layout direction for stacking: 'horizontal' (side by side) or 'vertical' (top on bottom).
  • secondary_video_mute (required) — Whether to mute the audio track of the secondary video.
  • mute — Whether to mute the audio track of the primary video.
  • wait — When enabled, the node polls the server until video processing is finished and returns the complete video object. When disabled, it returns immediately with the video ID and timestamp.
  • webhook_url — Optional webhook URL to receive notifications with the video ID and result URL once processing completes.

Output shape

a single JSON object

If 'Wait for Completion' is enabled, the output includes full video details and the public result URL. If disabled, the response contains only the job ID and creation timestamp.

Examples

Example 1: Stack two videos side-by-side

Set Video - Name to 'Comparison Video', Video - URL and Secondary Video - URL to public MP4 links, and Layout to 'Horizontal'.

Example 2: Stack two videos vertically and mute the secondary video

Set Video - Name to 'Reaction Video', Layout to 'Vertical', Secondary Video - Mute to true, and enable Wait for Completion.

Links

Discussion