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.

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 to 4K), and framerate
• Media Inputs: Add multiple video or image clips with URLs
• 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

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

Resources

• n8n community nodes documentation
• Samautomation API documentation

License

MIT