Clipmagic Api icon

Clipmagic Api

Interact with ClipMagic API for video and audio processing
Join our community

Actions8

Overview

This node interacts with the ClipMagic API to perform various video and audio processing operations, specifically including burning subtitles into videos. It is useful for users who want to embed subtitles directly onto video files, customizing the appearance and output format. Practical examples include creating videos with hardcoded captions for accessibility or social media sharing, where subtitles are part of the video stream.

Use Case Examples

  1. Embedding subtitles from an .srt file into a video with customized font size and color.
  2. Converting a video to a specific resolution and orientation while burning captions.
  3. Adding a background box to subtitles for better visibility in the output video.

Properties

Name Meaning
Options Extra settings for the request, such as timeout duration for the HTTP call.
Video URL URL of the input video to which subtitles will be burned.
Subtitle URL URL of the subtitle file (.srt or .ass) to burn into the video.
Font Size Font size of the subtitle text in pixels.
Font Color Primary color of the subtitle text.
Font Name Font name to use for subtitles, can be a system font or a URL to a font file.
Outline Width Width of the text outline; 0 means no outline.
Boxed Subtitles Whether subtitles should have a background box for better visibility.
Resolution Resolution of the output video (e.g., 480p, 720p, 1080p, 1440p, 4K).
Orientation Orientation of the output video (Landscape, Portrait, or Square).
Output Filename Desired filename for the output file without extension.

Output

Binary

The node outputs the processed video file with burned-in subtitles as binary data, including the filename and content type in the metadata.

JSON

  • success - Indicates if the operation was successful.
  • operation - The operation performed, e.g., 'burnCaptions'.
  • filename - The name of the output file.
  • contentType - The MIME type of the output file.

Dependencies

  • ClipMagic API

Troubleshooting

  • Ensure the input video URL and subtitle URL are accessible and correctly formatted; inaccessible URLs will cause request failures.
  • Timeout errors may occur if the processing takes longer than the specified timeout; increase the timeout setting if needed.
  • Invalid subtitle file formats or corrupted subtitle files may cause the operation to fail.
  • If the output filename is not specified, the system will generate a default filename based on the response headers.

Links

Discussion