Read before this
Read these direct prerequisites in order. Each guide lists any earlier context it assumes.
Overview
ngram publishes a community node package, n8n-nodes-ngram, that adds video actions and event triggers to n8n. It calls the same public API as the other automation surfaces and uses an API key you create in ngram Settings.
Install the community node
The easiest way to get started is from ngram's verified integration page on n8n.io - it walks you through installing the node on your instance and lists everything the integration can do.
Or install it from inside n8n: click + in the top right of the editor to open the Nodes panel and search Ngram. It's a verified community node, so it's discoverable directly on both self-hosted n8n and n8n Cloud - an instance owner approves it once, and anyone on the instance can add it after that.
For reference, see the package on npm and n8n's community node install guide.
Add your credential
Create a credential from Settings → API Keys, then add it to n8n Credentials. The node sends the credential as Authorization: Bearer ngs_… on every call, so a single credential covers every ngram node in your workflows.
Nodes
| Node | Type | What it does |
|---|---|---|
| Create Video | Action | Start a render from a prompt, with optional website, voice, style, aspect ratio and duration. |
| Create From Text | Action | Turn a prompt or source text into a video. |
| Create From URL | Action | Research a webpage, article, product page or doc and create a video from it. |
| Get Status | Action | Fetch a video's status and finished MP4 URL by id. |
| On Video Ready | Trigger | Fires when a render finishes, on the video.completed event. |
| On Video Failed | Trigger | Fires when a render fails, on the video.failed event. |
Example workflow
A minimal render-and-notify workflow looks like this:
- A Webhook or Schedule node kicks the workflow off.
- Create Video starts the render with your prompt and options.
- On Video Ready fires when the render finishes.
- An HTTP Request or Slack node posts the MP4 URL wherever you need it.