n8n-nodes-zapcap

This is an n8n community node that integrates with the Zapcap.ai REST API. It allows you to programmatically add animated, styled subtitles to videos and automatically slice viral clips/shorts from long-form content.

Features

• Video Management: Direct upload of local video files or URL-based uploads.
• Templates: Fetch designer templates directly.
• Tasks: Create video rendering and captioning tasks with customizable parameters (language, auto-approve, template, and advanced style properties).
• Transcript Editing: Retrieve and edit transcription text/timestamps before triggering rendering.
• AI Clipping: Automatically cut engaging viral shorts from longer videos with specific target durations.

Installation

Community Nodes (n8n Web UI)

If this package is published on npm, you can install it via the n8n interface:

1. Go to Settings > Community Nodes.
2. Click Install a new node.
3. Enter n8n-nodes-zapcap and click Install.

Manual Installation (Local Development)

For local testing or offline deployment:

1. Clone or copy this directory to your machine.
2. Build the project:

   npm install
   npm run build

3. Copy the compiled files into your local n8n custom directory:
   • Windows: Copy the entire directory or link it inside %USERPROFILE%\.n8n\custom\
   • Linux / macOS: Copy or link inside ~/.n8n/custom/
4. Restart your n8n instance.

Configuration & Credentials

To use the Zapcap node, you must set up a Zapcap API credential:

1. Go to the ZapCap Dashboard API Key page and copy your API Key.
2. In n8n, create a new Credential of type Zapcap API.
3. Paste your API Key into the credential field.

Operations Overview

Video

• Upload File: Upload a local video from a previous node's binary data (form-data upload).
• Upload via URL: Send a public URL of a remote video file (e.g. from S3, Google Drive, etc.).
• Get All Tasks: Retrieve a list of all render tasks or clip tasks associated with a video.

Task

• Create: Initialize subtitle transcription and rendering. You can specify:
  • templateId (Style Template)
  • language (48 supported languages)
  • autoApprove (Set to false if you want to edit transcripts before rendering)
  • renderOptions (JSON schema for fonts, colors, emoji inclusion, etc.)
• Get Status: Retrieve status of rendering (pending, transcribing, rendering, completed, failed).

Transcript

• Get: Fetch the JSON array of words, start/end timestamps.
• Update: Commit transcript edits (useful for correcting names/jargon before rendering).
• Approve: Approve a transcript manually to trigger video rendering (if autoApprove was set to false).

Clipping (Viral Shorts)

• Create Clipping Task: Extract 1-5 engaging viral clips. Specify the desired duration range (e.g., < 30s, 30-60s).
• Get Status: Check completion and retrieve direct download URLs and generated themes for each clip.

Template

• Get All: Return list of all designer subtitle templates available to your account.

License

MIT