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 every other surface, so a bearer key is the only credential you need.
Install the community node
On self-hosted n8n, open Settings → Community Nodes → Install, enter n8n-nodes-ngram, and confirm. The ngram nodes then appear in the node picker. Support on n8n Cloud is pending verification, so install on a self-hosted instance for now.
For reference, see the package on npm and n8n's community node install guide.
Add your credential
Create an ngram API credential and paste a key from Settings → API keys. The node sends it 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. |
| 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.