n8n-nodes-replicate-video

An n8n community node for generating videos using Replicate AI models.

Features

• Generate videos using Replicate AI models (e.g., bytedance/seedance-1-pro)
• Synchronous execution (waits for video generation to complete)
• Support for various video parameters (FPS, duration, resolution, aspect ratio)
• Easy credential configuration

Installation

Method 1: Install via npm (recommended for n8n Cloud)

cd /path/to/your-n8n-installation
npm install n8n-nodes-replicate-video

Method 2: Install as a global npm package

npm install -g n8n-nodes-replicate-video

Method 3: Manual installation (for development)

Clone this repository and link it to your n8n installation:

git clone https://github.com/yourusername/n8n-nodes-replicate-video.git
cd n8n-nodes-replicate-video
npm install
npm run build
cd /path/to/your-n8n-installation
npm link /path/to/n8n-nodes-replicate-video

Setup

1. Get your Replicate API token from https://replicate.com/account/api-tokens
2. In n8n, go to Settings > Credentials
3. Click Add Credential
4. Search for Replicate API
5. Enter your API token
6. Save the credential

Usage

Basic Video Generation

1. Add the Replicate Video node to your workflow
2. Select your Replicate API credential
3. Configure the parameters:
   • Model: Enter the model ID (e.g., bytedance/seedance-1-pro)
   • Prompt: Describe the video you want to generate
   • FPS: Frames per second (default: 24)
   • Duration: Video length in seconds (default: 5)
   • Resolution: Output quality (720p or 1080p)
   • Aspect Ratio: Video format (16:9, 9:16, 1:1, 4:3, 3:4)
   • Camera Fixed: Whether camera movement should be disabled

Example Workflow

{
  "nodes": [
    {
      "parameters": {
        "model": "bytedance/seedance-1-pro",
        "prompt": "A serene sunset over mountains with golden light",
        "fps": 24,
        "duration": 5,
        "resolution": "1080p",
        "aspectRatio": "16:9",
        "cameraFixed": false
      },
      "name": "Generate Video",
      "type": "n8n-nodes-replicate-video.ReplicateVideo",
      "typeVersion": 1,
      "position": [450, 300],
      "credentials": {
        "replicateApi": {
          "id": "your-credential-id",
          "name": "Replicate API"
        }
      }
    }
  ]
}

Output

The node returns the following data:

• generated_video_url: The URL to the generated video
• generated_video_urls: Array of video URLs (if multiple outputs)
• id: Prediction ID
• status: Prediction status
• created_at: Creation timestamp
• completed_at: Completion timestamp
• metrics: Processing metrics (if available)

Supported Models

This node works with any Replicate model, but is particularly optimized for:

• bytedance/seedance-1-pro - Text-to-video generation

Requirements

• n8n version 1.0.0 or higher
• Node.js version 18.0.0 or higher
• A valid Replicate API token

Development

Setup

git clone https://github.com/yourusername/n8n-nodes-replicate-video.git
cd n8n-nodes-replicate-video
npm install

Build

npm run build

Development Mode

npm run dev

Lint

npm run lint

Test

npm test

License

MIT License - see LICENSE for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

• Create an issue on GitHub
• Check the n8n community forum for help

Changelog

1.0.0 (2024-02-13)

• Initial release
• Support for video generation with Replicate AI
• Synchronous execution mode
• Support for Seedance 1 Pro model