n8n-nodes-twelve-labs

This is an n8n community node that integrates Twelve Labs into your n8n workflows.

Twelve Labs provides state-of-the-art video understanding AI that enables you to search, analyze, and generate insights from video content. With this node, you can upload videos, create searchable indexes, and leverage powerful AI models to understand video content at scale.

n8n is a fair-code licensed workflow automation platform.

Table of Contents

• Installation
• Setup Guide
• Authentication
• Operations
• Compatibility
• Usage Examples
• Resources
• Contributing
• License

Installation

Follow the installation guide in the n8n community nodes documentation.

Quick Install

# Install globally in n8n
cd ~/.n8n/nodes
npm install n8n-nodes-twelve-labs
# Restart n8n

Setup Guide

For detailed instructions on building and installing this node from source, including development setup and troubleshooting, please refer to the Setup Guide.

Authentication

This node requires a Twelve Labs API key for authentication:

1. Sign up for a Twelve Labs account at Twelve Labs Dashboard
2. Navigate to the API Keys section
3. Generate a new API key
4. In n8n, create new Twelve Labs API credentials
5. Enter your API key and save

Operations

Index Resource

Manage video indexes where your videos are stored and processed.

• Create Index - Create a new searchable index with AI models
  • Choose from models: Pegasus Plus, Marengo Plus
  • Configure model options and addons
• List Indexes - Retrieve all indexes in your account
• Search Index by Name - Find a specific index by name

Video Resource

Handle video uploads and management within indexes.

• Upload Video - Upload videos to an index
  • Support for direct file uploads
  • Support for video URLs
  • Automatic processing and indexing
• List Videos - Get all videos in a specific index
  • Returns video metadata
  • Includes processing status

Analysis Resource

Generate AI-powered insights from your videos.

• Generate Summary - Create concise summaries of video content
  • Customizable summary types
  • Adjustable prompt templates
• Generate Chapters - Automatically segment videos into chapters
  • Smart chapter detection
  • Timestamped segments
• Generate Highlights - Extract key moments from videos
  • Identify important scenes
  • Create highlight reels

Compatibility

• n8n Version: Requires n8n version 1.0.0 or later
• Node.js: Version 18.x or higher
• Platform: Works on Windows, macOS, and Linux

Tested with:

• n8n v1.70.0+
• Node.js v18.x, v20.x

Usage Examples

Import Example Workflow

A ready-to-use workflow template is available in the examples/ folder:

twelve_labs_search_chat_video.json - Complete pipeline demonstrating:

1. Create Index (Marengo + Pegasus models)
2. Upload Video from file
3. Search Index with natural language
4. Chat with Video using AI

To import: In n8n, go to Workflows → Create new workflow → Import from File or URL.

Basic Video Processing Workflow

1. Upload a Video

   • Select or create an index
   • Choose file or URL upload
   • Video is automatically processed

2. Generate Insights

   • Use the Analysis resource
   • Select summary, chapters, or highlights
   • Receive AI-generated content

3. Integrate Results

   • Send summaries to Slack
   • Store chapters in a database
   • Create clips from highlights

Example Workflow Ideas

• Content Moderation: Upload videos and analyze for specific content
• Video Library Management: Automatically catalog and tag video content
• Educational Content: Generate chapters and summaries for courses
• Marketing Insights: Extract highlights for social media clips
• Compliance Monitoring: Search videos for specific activities or objects

Resources

Documentation

• n8n Community Nodes Documentation
• Twelve Labs API Documentation
• Twelve Labs Platform Guide

Support

• n8n Community Forum
• Twelve Labs Support
• GitHub Issues

Contributing

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

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Thanks to the n8n team for creating an amazing automation platform
• Thanks to Twelve Labs for providing powerful video understanding AI
• Thanks to all contributors who help improve this integration

Made with ❤️ for the n8n community