Overview
This node enables users to create advanced videos programmatically using the Samautomation API. It supports composing videos from multiple clips (videos or images), adding audio tracks including background music and voice overs with ducking options, overlaying captions with customizable fonts and timings, applying watermarks with position and opacity controls, and setting output video parameters such as aspect ratio, resolution, framerate, and render quality.
Common scenarios include automated video content creation for marketing, social media posts, tutorials, or presentations where dynamic assembly of media elements is required without manual video editing. For example, a user can generate a promotional video by combining product images, background music, voice narration, and branded watermark automatically.
The node also supports checking the progress of an ongoing video rendering task and retrieving the final rendered video file once complete.
Properties
| Name | Meaning |
|---|---|
| Output Settings | Settings controlling the output video format: - Aspect Ratio: Choose from 16:9, 9:16, 1:1, 4:3, 3:4. - Resolution: Options are 480p, 720p, 1080p, 4K. - Framerate: Select frame rate from 24, 25, 30, or 60 fps. |
| Main Clips | Collection of media clips to include in the video: - Type: Video or Image. - URL: Link to the media file. - Duration (for images only): How long the image is displayed in seconds. |
| Audio Settings | Audio configuration: - Background Music URL: Link to background music file. - Background Music Volume %: Volume level 0-100. - Voice Over URL: Link to voice over audio. - Voice Over Volume %: Volume 0-100. - Ducking: Enables volume ducking with settings for reduction factor (0-1), attack time (seconds), and release time (seconds). |
| Caption Elements | Captions to overlay on the video: - Text Content: Caption text. - Font: Font family choice (Arial, Helvetica, Times New Roman, Montserrat variants, Bangers, DK Mandarin Whispers, Impact). - Start Time: When caption appears (seconds). - Duration: How long caption stays visible (seconds). |
| Watermark | Watermark image overlay: - URL: Link to watermark image. - Position: Placement on video (Top Left, Top Right, Bottom Left, Bottom Right, Center). - Opacity: Transparency level 0-1. - Scale: Size scale 0.01-1. - Margin: Margin in pixels from edges. |
| Render Options | Rendering quality: - Quality: Low, Medium, or High. |
| Task ID | (For "Get Render Progress" operation) The identifier or full URL of a previously started render job to check its status and retrieve results. |
Output
- For Create Advanced Video operation, the node outputs JSON containing details about the created video render task, including a unique progress URL to track rendering status.
- For Get Render Progress operation, the node outputs JSON with the current state of the render job. If rendering is complete and the output video URL is available, it downloads the video binary data and attaches it as binary output named
datawith MIME typevideo/mp4. - In case of errors, the output JSON includes an error message and success flag set to false.
Dependencies
- Requires an API key credential for authenticating with the Samautomation API.
- Uses the SamautomationClient SDK internally to communicate with the API endpoints.
- Network access to URLs provided for media files (clips, audio, watermark) must be available.
- No additional environment variables are needed beyond the API key credential.
Troubleshooting
- Invalid or missing API key: The node will fail if the API key credential is not set or invalid. Ensure correct API key is configured.
- Invalid media URLs: If clip, audio, or watermark URLs are unreachable or incorrect, the video creation may fail or produce incomplete results.
- Progress retrieval errors: When fetching render progress, if the task ID or URL is wrong or expired, the node will return an error.
- Binary download failures: If the final video cannot be downloaded due to network issues or invalid output URL, an error message will appear in the output JSON under
download_error. - To handle errors gracefully, enable "Continue On Fail" in the node settings to allow workflow continuation despite failures.