gradium

Independent n8n community node for Gradium speech APIs

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.1
Author: khmuhtadin

Available Nodes

Documentation generating…

Documentation

n8n-nodes-gradium

An independent community node for Gradium. Not affiliated with or endorsed by Gradium.

Install

In a self-hosted n8n instance, go to Settings > Community nodes > Install, enter n8n-nodes-gradium, and confirm. Alternatively install it in your n8n custom extensions directory and restart n8n. This package has not been published to npm yet.

Credentials

Create an API key in your Gradium account and add a Gradium API credential in n8n. The node sends the key in x-api-key. The credential test calls the authenticated credits endpoint; it does not generate audio.

Operations

  • Text to Speech: produce raw audio in an n8n binary property. Choose a voice ID and format. Docs.
  • Speech to Text: send an input binary WAV, 24 kHz 16-bit mono PCM, or Ogg Opus file. Set a language code or any for detection. The node buffers and parses NDJSON and returns text plus messages. Docs.
  • List Voices and Get Voice: list account/catalog voices or fetch one by ID. OpenAPI.
  • Get Credits: inspect the current credit balance. Docs.

The OpenAPI server is https://api.gradium.ai/api and its TTS path is /speech/tts, giving https://api.gradium.ai/api/speech/tts. /post/speech/tts is not a path in that spec. Operations may consume credits; check Gradium's current pricing. TTS and ASR buffer whole responses/files, so use suitable size limits. The icon is a neutral placeholder, not a Gradium logo.

Example

Import examples/text-to-speech.json, assign your credential and replace the voice ID. Run it and inspect the output binary data property.

Workflow template

examples/template-gradium-voice-prompt-checks.json: Check customer-care voice prompts with Gradium, Google Sheets and Slack. Import it in n8n (Workflows > Import from file). Setup steps are in the yellow sticky note.

Development

Run npm ci --ignore-scripts, npm run build, npm run lint, and npm test.

About the author

Khairul Muhtadin, n8n Ambassador: https://www.linkedin.com/in/khmuhtadin

Discussion