Actions7
Overview
This node integrates with the ClipMagic API to perform various video and audio processing tasks. It supports operations such as converting media formats, trimming segments, compressing videos, burning subtitles into videos, removing silence from media, stitching multiple videos together, and generating AI clips with karaoke-style subtitles.
Typical use cases include:
- Converting audio or video files to different formats for compatibility.
- Trimming unwanted parts from media files.
- Compressing videos to reduce file size while maintaining quality.
- Adding subtitles permanently onto videos.
- Removing silent sections from recordings to improve flow.
- Stitching multiple video clips into a single video.
- Automatically generating clips with stylized subtitles for social media or presentations.
For example, you could convert a WAV audio file to MP3, trim a 10-second segment from a video, or generate karaoke subtitles on a music video.
Properties
| Name | Meaning |
|---|---|
| Options | Extra settings for the request. Currently supports: Timeout (ms) - how long to wait before aborting the HTTP call (0 means no limit). |
| Operation | The action to perform. Options include: Convert Media, Trim Media, Compress Video, Burn Captions, Remove Silence, Stitch Videos, Generate AI Clips. |
| url / urls | Input media URL(s). Depending on operation, this can be a direct file URL, Google Drive link, or JSON/comma-separated list of URLs. |
| outputFormat | Target format for output media. Options vary by operation but include common audio/video formats like mp3, wav, mp4, mov, avi, gif, etc. |
| resolution | Video resolution scaling (e.g., 360p, 720p, 1080p). Ignored for audio-only operations. |
| bitrateKbps | Target video bitrate in kbps for conversion (max 3000, 0 for automatic). |
| trimMode | For trimming: whether to trim a single segment or multiple segments. |
| start, end, duration | Start time, end time, or duration for trimming segments, specified in HH:MM:SS or seconds. |
| segments | Multiple segments to trim when using multiple segment mode. Each segment has start, end/duration. |
| outputFilename | Optional custom filename for the output file (without extension). |
| preset | Encoding speed/quality preset for compression or silence removal (e.g., ultrafast, medium, slow). |
| crf | Constant Rate Factor controlling quality for compression or silence removal (lower is better quality). |
| subtitleUrl | URL to subtitle file (.srt or .ass) for burning captions. |
| fontSize, fontColor, fontName, outline, boxed | Styling options for burned subtitles including font size, color, name, outline width, and background box. |
| subtitlePosition | Vertical alignment of subtitles (top, centre, bottom). |
| orientation | Output video orientation (landscape, portrait, square). |
| noiseThreshold, duration (remove silence) | Threshold and minimum duration to detect silence in media. |
| highlightColor, primaryColor, fontWeight, shadowColor, shadowIntensity, displayMode, subtitlePosition (generate clips) | Styling and display options for generated karaoke subtitles. |
Output
The node outputs JSON data describing the success status, operation performed, and any returned metadata from the API. If the response contains media content (audio/video), it outputs binary data under the binary.data field along with metadata such as filename and content type.
- json: Contains fields like
success(boolean),operation(string), and additional API response data. - binary.data: Contains the raw media file data if the API returns a media file (video/audio).
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
- Timeouts: If the operation takes too long, increase the timeout option or set it to 0 for no limit.
- Invalid URLs: Ensure input media URLs are accessible and correctly formatted.
- Unsupported formats: Check that the requested output format is supported for the chosen operation.
- API errors: Errors from the ClipMagic API will be returned in the node output. Review error messages for issues like invalid parameters or authentication failures.
- Parsing errors: When providing multiple URLs for stitching, ensure the input is valid JSON array or comma-separated list.
- Credential issues: Make sure the API key credential is properly configured and has necessary permissions.
Links and References
- ClipMagic Official Website
- ClipMagic API Documentation (hypothetical, check actual docs)
- n8n documentation on Creating Custom Nodes