ClipMagic icon

ClipMagic

Interact with ClipMagic API for video and audio processing

Actions7

Overview

This node integrates with the ClipMagic API to perform various video and audio processing tasks. Specifically, the "Compress Video" operation reduces the file size of a given video by re-encoding it using specified encoding presets and quality settings. This is useful for optimizing videos for web delivery, saving storage space, or preparing videos for faster streaming.

Practical examples include:

  • Compressing large raw footage before uploading to a content management system.
  • Reducing video size for email attachments or social media sharing.
  • Adjusting video quality and encoding speed to balance between compression time and output quality.

Properties

Name Meaning
Video URL URL of the input video to be compressed.
Preset Encoding speed preset that controls the trade-off between encoding speed and compression efficiency. Options: Ultra Fast, Super Fast, Very Fast, Faster, Fast, Medium, Slow, Slower, Very Slow, Placebo.
CRF (Quality) Constant Rate Factor controlling output quality (lower is better). Typical values: 18 (nearly lossless), 23 (default), 28 (low quality).
Output Format Output container format for the compressed video. Options: MP4, MOV, AVI.

Output

The node outputs a JSON object containing:

  • success: Boolean indicating if the operation succeeded.
  • operation: The name of the operation performed ("compress").
  • filename: The filename of the resulting compressed video.
  • contentType: The MIME type of the output video.

Additionally, the node provides the compressed video data as binary under the binary.data field, allowing downstream nodes to access the actual video file.

Dependencies

  • Requires an API key credential for authenticating with the ClipMagic API.
  • The node makes HTTP requests to the ClipMagic service endpoint configured in the credentials.
  • No other external dependencies are required.

Troubleshooting

  • Common issues:

    • Invalid or inaccessible video URL may cause the API to fail.
    • Incorrect output format or unsupported codec combinations might result in errors.
    • Network connectivity problems can prevent successful API calls.

  • Error messages:

    • "Unknown operation: compress": Indicates the operation parameter was not set correctly; ensure "Compress Video" is selected.
    • API errors returned from ClipMagic will be included in the error message; check the video URL and parameters.

  • Resolutions:

    • Verify the video URL is publicly accessible and correctly formatted.
    • Use supported output formats listed in the properties.
    • Ensure the API key credential is valid and has necessary permissions.
    • Enable "Continue On Fail" to handle individual item failures gracefully.

Links and References

Discussion