Actions7
Overview
This 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 clips from a source video URL, optionally adding karaoke-style subtitles with customizable appearance.
Common scenarios where this node is beneficial include:
- Automatically generating highlight clips from longer videos.
- Creating engaging karaoke-style subtitle overlays for music or speech videos.
- Enhancing video content with visually appealing, synchronized subtitles for accessibility or entertainment.
For example, a user can input a video URL and enable subtitle generation to produce clips that display highlighted lyrics or spoken words in real-time, customizing colors, fonts, and subtitle positioning to match their branding or style preferences.
Properties
| Name | Meaning |
|---|---|
| Options | Extra settings for the request. Currently supports: Timeout (ms) - how long to wait before aborting the HTTP call (0 for no limit). |
| Video URL | Source video URL to generate AI clips from. |
| Generate Subtitles | Boolean flag to enable or disable karaoke-style subtitle generation. |
| 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 (shown only if subtitles are enabled). |
| Font Size | Size of the subtitle text in pixels (shown only if subtitles are enabled). |
| Font Weight | Weight of the subtitle text; options are 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 | Subtitle display style; options are Monoline or Word by Word (shown only if subtitles are enabled). |
| Subtitle Position | Vertical alignment of subtitles; options are Top, Centre, or Bottom (shown only if subtitles are enabled). |
Output
The node outputs JSON data describing the success status and details of the operation. If the response contains media data (video/audio), it outputs binary data under the binary.data field along with metadata:
json.success: Indicates whether the operation was successful (trueorfalse).json.operation: The operation performed, here always"generateClips".json.filename: The filename of the returned media file (if available).json.contentType: MIME type of the returned media.binary.data: Contains the actual media file data (video/audio clip).
If the response is not media but JSON, the output includes the parsed JSON fields merged into the json output.
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 the credentials.
- No additional environment variables are required beyond the API authentication setup.
Troubleshooting
- Timeouts: If the operation takes too long, increase the "Timeout (ms)" option or set it to 0 for no limit.
- Invalid URLs: Ensure the provided video URL is accessible and correctly formatted.
- API Errors: The node throws errors if the ClipMagic API returns failures or if unknown operations are specified.
- Binary Data Handling: If the output does not contain expected media, verify the content-type header and ensure the API response is correct.
- Subtitle Options: Subtitle-related properties only apply if "Generate Subtitles" is enabled; otherwise, they are ignored.
Links and References
- ClipMagic Official Website
- ClipMagic API Documentation (for detailed API parameters and usage)
- n8n Documentation on Creating Custom Nodes