ClipMagic icon

ClipMagic

Interact with ClipMagic API for video and audio processing

Overview

This node integrates with the ClipMagic API to perform various video and audio processing tasks. Specifically, the "Stitch Videos" operation allows users to combine multiple video files sequentially into a single output video. This is useful when you have several clips that need to be merged into one continuous video without manual editing.

Common scenarios include:

  • Combining recorded segments of an event into a single video.
  • Merging tutorial parts or episodes into one file.
  • Creating highlight reels from multiple short clips.

For example, if you have three separate video URLs representing different scenes, you can provide them as input, and the node will stitch them together in the specified order, producing a single MP4 or MOV video file.

Properties

Name Meaning
Options Extra settings for the request. Contains:
- Timeout (ms): How long to wait before aborting the HTTP call. Set to 0 for no limit.
Video URLs JSON array or comma-separated list of video URLs to stitch in order.
Output Format Output container/codec. Options: MP4, MOV
Output Filename Desired filename for the output video (without extension). Optional.

Output

The node outputs a JSON object containing:

  • success: Boolean indicating if the operation was successful.
  • operation: The name of the operation performed ("stitch").
  • filename: The name of the output video file including extension.
  • contentType: The MIME type of the returned media (e.g., video/mp4).

Additionally, the node provides binary data under the binary.data property, which contains the actual stitched video file content. This binary data can be used downstream in workflows for saving, uploading, or further processing.

Dependencies

  • Requires an API key credential for authenticating with the ClipMagic API.
  • Needs network access to the ClipMagic service base URL.
  • The node uses HTTP requests with JSON payloads to communicate with the API.

Troubleshooting

  • Timeouts: If stitching large videos or many files, increase the timeout option to avoid premature aborts.
  • Invalid URLs: Ensure all provided video URLs are accessible and valid; otherwise, the API may return errors.
  • Output format issues: Only MP4 and MOV formats are supported for stitching; selecting unsupported formats will cause errors.
  • Parsing video URLs: The node attempts to parse the input as JSON array first; if parsing fails, it treats the input as a comma-separated list. Malformed JSON or incorrect formatting may lead to unexpected behavior.

Common error messages:

  • "Unknown operation": Occurs if the operation parameter is not set to "stitch".
  • Network or authentication errors: Check API key validity and network connectivity.
  • Invalid input data errors: Verify the format and accessibility of video URLs.

Links and References

Discussion