ozor

n8n community node for Ozor AI Video Generation API

Package Information

Released: 4 mo ago
Downloads: 36 weekly / 128 monthly
Latest Version: 0.1.13
Author: Martin Muller

Documentation

n8n-nodes-ozor

Community n8n node for the Ozor AI Video Generation API.

Generate, edit, export, and turn documents into narrated videos — directly from your n8n workflows.

Operations

The node exposes two resources: Video and Document.

Video

Operation Description
Generate Video Create a new video from a text prompt (with optional image/video refs)
List Videos Retrieve API-created videos (newest first)
Get Video Details Status, export info, downloadUrl / shareUrl
Export Video Trigger an MP4 render at 720p / 1080p / 4K, public or signed
Send Message (Edit) Iterate on a video — change copy, swap colors, reorder scenes, etc.
Get Job Status Poll a generate / message agent job

Document

Operation Description
List Voices Available TTS voices
Analyze Document Upload a PDF / PPTX / DOCX (binary input) or a URL → scene-by-scene plan
Get Plan Retrieve a plan (image URLs are refreshed on every read)
Update Plan Edit scenes or voice settings before generation
Generate From Plan Render the plan into a video (consumes the SSE stream and returns projectId)

Features

  • Auto-export on generate — trigger export immediately when creating a video.
  • Public share links — set Export Is Public / Is Public to get a permanent shareUrl + shareCode.
  • Wait for completion — built-in polling for both agent jobs and exports; downstream nodes receive the final downloadUrl / shareUrl / agent reply directly.
  • Media attachments — pass image and video references (URL or base64) to generate and message.
  • Aspect ratio & quality — landscape (16:9) or portrait (9:16); 720p, 1080p, or 4K.
  • Document-to-video — upload a PDF/PPTX/DOCX as n8n binary data, or hand in a URL.

Setup

1. Get your API key

Sign up at ozor.ai and create an API key in the dashboard (Settings → API Keys).

2. Install the node

In n8n (community nodes)

Go to Settings → Community Nodes → Install and enter:

n8n-nodes-ozor

Manual / development

cd ~/.n8n/custom
git clone https://github.com/Mintii-Labs/n8n-nodes-ozor.git
cd n8n-nodes-ozor
npm install
npm run build

Then restart n8n.

3. Add credentials

In n8n, go to Credentials → New → Ozor API and paste your API key. The credential test hits GET /api/v1/videos to validate the key.

Example workflows

Prompt → generate → public share link

  1. Manual Trigger (or Webhook)
  2. Ozor — Resource: Video, Operation: Generate Video
    • Enable Auto-Export, Export Is Public, Wait for Export
  3. Slack / Email — send {{$json.shareUrl}}

Edit an existing video

  1. Ozor — Operation: Send Message (Edit)
    • Video ID: abc123, Message: "Add our logo in the top-right corner", Wait for Agent: on
  2. Ozor — Operation: Export Video
    • Video ID: ={{$json.videoId}}, Wait for Export: on

PDF → narrated video

  1. Read/Download File (produces binary data)
  2. Ozor — Resource: Document, Operation: Analyze Document
    • Input Type: Binary File, Binary Property: data
  3. (optional) Ozor — Operation: Update Plan (rewrite voiceover / pick a voice)
  4. Ozor — Operation: Generate From Plan → returns projectId
  5. Ozor — Operation: Export Video, Video ID: ={{$json.projectId}}

Development

npm install
npm run dev      # watch mode
npm run build    # production build
npm run lint     # lint

Publishing to npm

npm login
npm publish

License

MIT

Discussion