Actions7
Overview
This node integrates with the ClipMagic API to perform various video and audio processing tasks. Specifically, the "Burn Captions" operation allows users to embed subtitles directly into a video file. This is useful for creating videos with hardcoded captions that are always visible, regardless of the playback device or player settings.
Common scenarios include:
- Adding subtitles to videos for accessibility or localization.
- Creating social media videos where captions improve engagement.
- Preparing videos for platforms that do not support separate subtitle files.
For example, you can provide a video URL and a subtitle file URL (.srt or .ass), customize font size, color, and style, and receive a new video file with the subtitles permanently burned in.
Properties
| Name | Meaning |
|---|---|
| Video URL | URL of the input video to which subtitles will be burned in. |
| Subtitle URL | URL of the subtitle file (.srt or .ass) containing the captions to burn into the video. |
| Font Size | Font size of the subtitle text in pixels (default 24). |
| Font Color | Primary color of the subtitle text (default white #FFFFFF). |
| 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 in pixels; 0 means no outline (default 0). |
| Boxed Subtitles | Boolean indicating whether subtitles should have a background box behind the text (default false). |
| Resolution | Output video resolution; options: 480p, 720p, 1080p, 1440p, 4K (default 720p). |
| Orientation | Orientation of the output video; options: Landscape, Portrait, Square (default Landscape). |
| Output Filename | Desired filename for the output video file without extension (optional). |
Output
The node outputs a JSON object and binary data representing the processed video:
json: Contains metadata about the operation result:
success: Boolean indicating if the operation succeeded.operation: The operation performed ("burnCaptions").filename: The name of the output video file.contentType: MIME type of the output file (e.g., video/mp4).
binary.data: The actual video file with burned-in subtitles, ready for download or further processing.
Dependencies
- Requires an API key credential for authenticating with the ClipMagic API.
- The node makes HTTP requests to the ClipMagic service endpoint.
- Input video and subtitle files must be accessible via URLs.
- No additional local dependencies are required.
Troubleshooting
- Invalid URLs: Ensure the video URL and subtitle URL are publicly accessible or properly authenticated links.
- Unsupported subtitle formats: Only
.srtand.asssubtitle files are supported. - Font issues: If specifying a custom font by URL, ensure the font file is accessible and compatible.
- API errors: Network issues or invalid credentials will cause request failures; verify API key validity and network connectivity.
- Output filename conflicts: If the output filename is not specified, a default name is used; naming conflicts might occur if saving locally afterward.
If the node throws an error like "Unknown operation," verify that the operation parameter is set exactly to "burnCaptions."
Links and References
- ClipMagic API Documentation (general reference for API capabilities)
- Subtitle file format specifications:
This summary covers the "Burn Captions" operation of the ClipMagic node based on static code analysis and provided property definitions.