n8n-nodes-samautomation

This is an n8n community node that allows you to use the Samautomation Advanced Video Rendering API in your n8n workflows.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Usage
Resources

Installation

Follow the installation guide in the n8n community nodes documentation. Grab your api key from samautomation.work

Operations

Create Advanced Video

Start an advanced video render job with full customization options:

• Output Settings: Configure aspect ratio (16:9, 9:16, 1:1, etc.), resolution (480p, 720p, 1080p) and framerate
• Media Inputs: Add multiple video or image clips with URLs. For images: configure zoom effects (zoom_intensity) and twist rotation (twist_angle) for dynamic visual effects
• Audio Settings: Add background music and voice-over with volume controls
• Caption Elements: Add timed text captions with precise start times and durations
• Watermark: Add a logo or watermark with position, opacity, and scale controls
• Render Options: Choose between full quality or preview mode

Get Render Progress

Check the status of a video render job using the task ID.

Credentials

To use this node, you need:

1. API Key: Your Samautomation API key (sent via X-API-Key header)
2. Base URL: API root, without trailing slash or /api (default: https://samautomation.work)

Compatibility

• n8n version: >=1.9.0
• Node.js version: >=20.0.0

Usage

Basic Video Creation

1. Add the Samautomation node to your workflow
2. Configure your API credentials
3. Select "Create Advanced Video" operation
4. Add at least one video clip in Media Inputs
5. Configure any additional settings as needed
6. Execute the node to start rendering

Advanced Example

For a full-featured example covering all available options (output, media, audio, captions, watermark, render options) see docs/advanced-config-example.json. You can import this JSON directly into the Create Advanced Video operation via JSON View to get started quickly.

Supported Caption Fonts

| Font value (UI) | Internal family | | -------------- | -------------- | | Bangers | bangers | | Montserrat (Regular) | montserrat | | Montserrat Italic | montserrat-italic | | Montserrat Variable | montserrat-variable | | DK Mandarin Whispers | mandarin | | Arial | arial | | Helvetica | helvetica | | Times / Times New Roman | times | | Impact | impact |

Downloading the Rendered Video

When the Get Render Progress operation reports state = SUCCESS, the node automatically downloads the video file and returns it as binary data (binary.data). You can pipe this into n8n's Write Binary File node or upload directly to cloud storage.

Example Configuration

{
  "output_settings": {
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "framerate": 30
  },
  "media_inputs": {
    "main_clips": [
      {
        "type": "video",
        "url": "https://example.com/video1.mp4"
      }
    ]
  },
  "audio_settings": {
    "background_music_url": "https://example.com/music.mp3",
    "background_music_volume_percent": 25
  }
}

Workflow Examples

Social Media Video Generation

1. Trigger: New row in Google Sheets
2. Samautomation: Create video with data from sheet
3. Wait: Poll render status until complete
4. Upload: Post to social media platforms

Batch Video Processing

1. Read: Get data from Airtable
2. Loop: For each record
3. Samautomation: Create personalized video
4. Store: Save render IDs
5. Monitor: Check all render statuses

🚀 Quick Start – Importable Example Workflow

Want to see the Samautomation node in action without manually filling in every field? Import our example workflow and experience how quickly you can generate videos!

👉 Click here to download the workflow JSON

1. Download the file or copy the URL.
2. In n8n, go to Workflow → Import from file/URL.
3. Save the workflow and enter your own API key in the Samautomation node.
4. Execute – done! 🎉

🛠️ Node Options & Endpoint Overview

| Category | Key fields | |-----------|---------------------| | Output Settings | aspect_ratio, resolution (480p/720p/1080p), framerate | | Media Inputs | Multiple mainClips (video/image URL, start/end, effects) | | Audio Settings | background_music_url, background_music_volume_percent, voice_over_url, voice_over_volume_percent | | Caption Elements | text, start, duration, position, color, font (Arial, Helvetica, Impact, …) | | Watermark | logo_url, position, opacity, scale | | Render Options | preview_mode, quality |

Tip: Combineer meerdere categorieën om razendsnel professionele social-video’s te maken.

Resources

• n8n community nodes documentation
• Samautomation API

License

MIT