Package Information
Documentation
n8n-nodes-empiriolabs
This is an n8n community node package. It lets you use EmpirioLabs AI in your n8n workflows for chat, image generation, text to speech, transcription, video generation, and embeddings, and it can start a workflow when a generation job finishes.
EmpirioLabs AI is a specialized AI inference and integration provider. It self-hosts open-source models on GPU infrastructure it manages, runs optimized endpoints for proprietary models, helps teams ship their own models to large audiences, and offers on-demand GPU Cloud instances and hosted AI agents. Its model catalog covers text, image, audio, video, transcription, embedding, reranking, research, and 3D models.
n8n is a fair-code licensed workflow automation platform.
Installation
Operations
Trigger
Credentials
Compatibility
Usage
Development
Resources
Version history
Installation
Follow the installation guide in the n8n community nodes documentation and install the package n8n-nodes-empiriolabs.
Operations
The EmpirioLabs AI node supports these resources and operations. Every model list loads live from the EmpirioLabs AI model catalog and shows only the models that support the selected operation.
| Resource | Operation | What it does |
|---|---|---|
| Audio | Text to Speech | Turns text into speech and returns the audio as a binary file. Choose a model, a voice the model offers, and optionally a language and output format. |
| Audio | Transcribe | Turns speech into text from a binary file in the input item or from a public HTTPS file URL. Waits for the transcript by default and returns the text, language, and duration. |
| Chat | Create Completion | Sends a prompt (with an optional system message) or a full conversation to a chat model and returns the reply. Options include temperature, maximum number of tokens, top P, and JSON output. |
| Embedding | Create | Returns the embedding vector for a text. |
| Image | Generate | Creates images from a prompt and returns each image as a binary file in its own item. Options include aspect ratio, resolution, number of images, and reference image URLs for editing. |
| Job | Get | Returns the status and result of a job. Can also download the finished file as binary data. |
| Job | Get Many | Returns recent jobs, optionally filtered by status. |
| Model | Get Many | Returns models from the catalog, optionally filtered by category or search text. |
| Video | Generate | Starts a video generation job and returns the job. Turn on Wait for Completion to wait for the video, with a timeout, and download it as a binary file. |
Operations that create content also accept Model Parameters (JSON): extra request fields for the selected model, such as {"seed": 42}. Each model lists the fields it accepts on its page in the model catalog.
The node can be used as a tool by the n8n AI Agent.
Trigger
The EmpirioLabs AI Trigger node polls your recent jobs and starts the workflow when a job finishes.
- Event: Job Finished.
- Statuses: Completed, Failed, or Cancelled. Completed and Failed are selected by default.
- Filters: job type (image, video, music and sound, speech, transcription, or 3D generation) and model ID.
Each finished job starts the workflow once. When you activate the workflow, jobs that already finished are skipped. The jobs list covers the last hour, so keep the poll interval under an hour. When you test the trigger in the editor, it returns the most recent finished job.
Credentials
The nodes authenticate with an EmpirioLabs AI API key.
- Sign in or create an account at platform.empiriolabs.ai.
- Open API Keys in the dashboard and create a key. Keys start with
sk-empiriolabs-. - In n8n, create a new EmpirioLabs AI API credential and paste the key into API Key.
n8n checks the key with a request to GET https://api.empiriolabs.ai/v1/account/usage?limit=1, which does not use credits. Requests that run models use the credits on your account; prices are listed on the pricing page. See Authentication for more about API keys.
Compatibility
Built with the n8n node CLI (@n8n/node-cli 0.52) and tested against n8n-workflow 2.43. The package has no runtime dependencies.
Usage
- Choosing a model: each model list shows the models whose catalog entry supports the selected operation. To set a model by ID instead, switch the field to Expression and enter an ID from the models page.
- Voices: the Voice list shows the voices the selected text to speech model offers. Model Default uses the default voice of the model.
- Binary files: images, speech, and downloaded videos are returned in the binary field
data. Change it with Put Output in Field. For transcription, set Input Data Field Name to the binary field that holds the audio or video file. - Long jobs: video generation usually takes 1 to 15 minutes. Either turn on Wait for Completion and set a timeout, or keep the default, which returns the job right away, and continue with the Job resource or the trigger. Job results are kept for one hour after the job finishes.
- Generated file links expire 7 days after they are created. Download a file you want to keep, for example with the download options on the Video and Job resources.
- Errors: the node shows the message returned by the API, such as an unsupported parameter for the selected model. Turn on Continue On Fail in the node settings to keep the workflow running and return the message in the item instead.
Development
npm install
npm run build # compile to dist/
npm run lint # n8n community node lint rules
npm test # offline unit tests with a mocked n8n context
npm run scan:local # the lint passes of @n8n/scan-community-package, run locally
npm run dev # start n8n with this package loaded at http://localhost:5678
npm run scan:local installs @n8n/scan-community-package into .scan/ and runs its two lint passes against the source and against the files npm pack would publish. The published scan, npx @n8n/scan-community-package n8n-nodes-empiriolabs, also checks npm provenance, so it can only pass after a version is published from GitHub Actions.
The live smoke test is skipped unless you opt in. It runs the credential test and one short chat completion on the cheapest chat model in the catalog, which uses a small amount of credit:
EMPIRIOLABS_LIVE=1 EMPIRIOLABS_API_KEY=sk-empiriolabs-... npm run test:live
Set EMPIRIOLABS_LIVE_MODEL to choose the chat model.
Releasing
Versions are published to npm with a provenance statement by the Publish workflow when a version tag such as 0.1.0 is pushed. Run npm run release to bump the version, update the changelog, tag, and push.
Resources
- n8n community nodes documentation
- EmpirioLabs AI documentation
- EmpirioLabs AI API reference
- EmpirioLabs AI models
- npm package
- Support: support@empiriolabs.ai
Version history
0.1.1
Published from GitHub Actions through npm trusted publishing, with provenance. The README links the npm package.
0.1.0
First release: Audio (Text to Speech, Transcribe), Chat (Create Completion), Embedding (Create), Image (Generate), Job (Get, Get Many), Model (Get Many), Video (Generate), and the Job Finished trigger.