ClipMagic icon

ClipMagic

Interact with ClipMagic API for video and audio processing

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 in scenarios such as:

  • Automatically generating highlight clips from longer videos.
  • Creating engaging social media content with synchronized karaoke subtitles.
  • Enhancing accessibility by adding readable subtitles to video clips.

For example, a user can input a video URL and request AI-generated clips with karaoke subtitles that highlight the currently sung words in a chosen color and font style.

Properties

Name Meaning
Video URL Source video URL from which AI clips will be generated.
Generate Subtitles Boolean option to enable or disable karaoke-style subtitles on the generated clips.
Highlight Color Color used to highlight the currently sung text in karaoke mode (shown only if subtitles enabled).
Primary Color Primary color of the subtitle text (shown only if subtitles enabled).
Font Name Font name to use for subtitles (system font or custom) (shown only if subtitles enabled).
Font Size Size of the subtitle text in pixels (shown only if subtitles enabled).
Font Weight Weight of the subtitle text; options are "Normal" or "Bold" (shown only if subtitles enabled).
Shadow Color Color of the text shadow for subtitles (shown only if subtitles enabled).
Shadow Intensity Intensity of the text shadow; 0 means no shadow (shown only if subtitles enabled).
Display Mode Subtitle display style; options are "Monoline" or "Word by Word" (shown only if subtitles enabled).
Subtitle Position Vertical alignment of subtitles; options are "Top", "Centre", or "Bottom" (shown only if subtitles enabled).
Options Extra settings for the request:
- Timeout (ms) How long to wait before aborting the HTTP call in milliseconds. Set to 0 for no limit.

Output

The node outputs JSON data describing the result of the operation along with binary data containing the processed media file:

  • json: Contains fields such as:
    • success: Boolean indicating if the operation succeeded.
    • operation: The performed operation name ("generateClips").
    • Additional response data from the API when available.
  • binary.data: Contains the binary content of the generated video clip, including any embedded subtitles if requested. This binary data can be saved or further processed within n8n workflows.

Dependencies

  • Requires an API key credential for authenticating with the ClipMagic API.
  • The node makes HTTP requests to the ClipMagic service endpoint.
  • No additional environment variables are required beyond the API authentication setup.

Troubleshooting

  • Timeouts: If the operation takes too long, increase the "Timeout (ms)" property or set it to 0 for no timeout.
  • Invalid URLs: Ensure the provided video URL is accessible and correctly formatted.
  • API Errors: If the API returns errors, check the error message in the output JSON. Common issues include invalid credentials or unsupported video formats.
  • Subtitles Not Showing: Verify that "Generate Subtitles" is enabled and subtitle styling properties are correctly set.
  • Binary Data Missing: Confirm that the API response includes video/audio content and that the content-type header indicates media data.

Links and References

Discussion