ClipMagic icon

ClipMagic

Interact with ClipMagic API for video and audio processing

Actions7

Overview

The node integrates with the ClipMagic API to perform advanced video and audio processing tasks. Specifically, the "Generate AI Clips" operation allows users to create AI-generated video clips from a source video URL, optionally adding karaoke-style subtitles with customizable appearance.

This node is beneficial for content creators, marketers, educators, or anyone looking to automatically generate engaging video snippets with synchronized subtitles for social media, presentations, or tutorials. For example, you can input a long lecture video URL and generate short highlight clips with karaoke subtitles that emphasize spoken words in real-time.

Properties

Name Meaning
Video URL Source video URL to process.
Generate Subtitles Whether to generate karaoke style subtitles (true/false).
Highlight Color Color of the highlighted text in karaoke mode (shown only if subtitles are enabled).
Primary Color Primary color of the subtitle text (shown only if subtitles are enabled).
Font Name Font name to use for subtitles (system font or custom font) (shown only if subtitles enabled).
Font Size Size of the subtitle text in pixels (shown only if subtitles are enabled).
Font Weight Weight of the subtitle text; options: Normal or Bold (shown only if subtitles are enabled).
Shadow Color Color of the text shadow (shown only if subtitles are enabled).
Shadow Intensity Intensity of the text shadow; 0 means no shadow (shown only if subtitles are enabled).
Display Mode How to display subtitles; options: Word by Word or Full Text (shown only if subtitles enabled).
Subtitle Position Position of subtitles in the video frame; options: Top, Middle, Bottom (shown only if subtitles enabled).

Output

The node outputs JSON data and may include binary data depending on the response:

  • JSON output includes:

    • success: Boolean indicating if the operation succeeded.
    • operation: The operation performed ("generateClips").
    • Additional fields returned by the API describing the generated clips or metadata.

  • Binary output (if present) contains the actual media file data of the generated clips, with:

    • filename: The name of the output file.
    • contentType: MIME type of the output (e.g., video/mp4).
    • data: The binary content of the generated clip.

This allows downstream nodes to access either metadata or the actual video/audio clip files.

Dependencies

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

Troubleshooting

  • Common issues:

    • Invalid or missing video URL will cause the API call to fail.
    • Incorrect or missing API authentication will result in authorization errors.
    • Providing unsupported subtitle font names or colors might cause rendering issues.
    • Network connectivity problems can prevent successful API communication.

  • Error messages:

    • "Unknown operation": Occurs if an unsupported operation value is set; ensure "generateClips" is selected.
    • API errors returned from ClipMagic will be included in the node's error output if continueOnFail is enabled.
    • Binary data preparation errors may occur if the response content-type is unexpected.

  • Resolutions:

    • Verify all required parameters are correctly set.
    • Ensure valid API credentials are configured.
    • Check network access to the ClipMagic API endpoint.
    • Use supported formats and values for subtitle customization.

Links and References

Discussion