songs2vid/docs/n8n.md

n8n integration (OSS)

Automate self-hosted Songs2VID with the community package n8n-nodes-songs2vid.

Full hosted guide: https://docs.songs2vid.com/docs/n8n

Install

In n8n → Settings → Community nodes → install:

n8n-nodes-songs2vid

Or from this repo for local development:

cd integrations/n8n
npm install
npm run build

Auth

1. Dashboard → Settings → API key → create s2yt_live_…
2. n8n credential Songs2VID API: paste key, Base URL = your instance (e.g. http://localhost:3000)

OSS has no plan gate — API keys work whenever YouTube is connected.

Flow

1. Upload cover (type=image) and audio (type=audio)
2. Create Render (POST /api/v1/render) with paths + optional webhookUrl
3. Handle completion via n8n Webhook or poll GET /api/v1/jobs/:id

Package source: integrations/n8n.