Description

n8n-nodes-typecast


Integrate Typecast AI TTS into your n8n workflows with this community node.

Features

• Voice Resource

– Clone Voice: create a quick-cloned custom voice from a WAV or MP3 binary input
– Delete Cloned Voice: delete a quick-cloned voice by its uc_... voice ID
– Get All Voices: list voices with model / gender / age / use_case filters
– Get Voice: look up a single voice by ID via the V3 API
– Recommend Voices: find voice candidates from a text description

• Speech Resource

– Text to Speech: convert text to speech using a selected voice
– Text to Speech (Streaming): low-latency chunked audio via POST /v1/text-to-speech/stream
– Text to Speech with Timestamps: audio + word / character alignment for SRT / WebVTT caption generation

• Subscription Resource

– Get My Subscription: plan tier, credit usage, and concurrency limit at runtime

• Output controls

– target_lufs: absolute loudness normalization (-70.0 ~ 0.0 LUFS); mutually exclusive with Volume on the non-streaming endpoint

Node Structure

• Node: Typecast

– Resources: voice, speech, subscription
– Operations:
– voice: clone, delete, getMany, getOne, recommend
– speech: textToSpeech, textToSpeechStream, textToSpeechWithTimestamps
– subscription: getMy

Credentials Setup

1. Get your API key from Typecast Dashboard
2. In n8n, add new credentials of type Typecast API
3. Enter your API key

Usage Example

1. Add the Typecast node to your workflow
2. Select a resource and operation (e.g., Speech > Text to Speech)
3. Provide required parameters (e.g., Voice ID, Text)
4. Connect and run your workflow

Quick Cloning Example

1. Add a node that outputs an audio file as binary data, such as Read/Write Files from Disk or an HTTP download node.
2. Add Typecast > Voice > Clone Voice.
3. Set Audio Binary Property to the binary property name from the previous node, usually data.
4. Set Voice Name and Model, then run the node.
5. Use the returned voiceid (uc...) in a following Typecast > Speech > Text to Speech node by selecting Voice ID By ID.
6. When the cloned voice is no longer needed, pass the same uc_... ID to Typecast > Voice > Delete Cloned Voice.

Installation

Via npm

npm install @neosapience/n8n-nodes-typecast

Via n8n Community Nodes

Follow the n8n community node installation guide.

In n8n, go to Settings > Community Nodes and install:

@neosapience/n8n-nodes-typecast

Compatibility

• n8n v1.0+

Development

Install dependencies
npm install
Build the node
npm run build
Format
npm run format
Run development mode
npm run dev

Release validation

The release workflow validates and publishes a separate package manifest without development dependencies or development-only overrides. Source development pins are retained. The published package must pass the unchanged official community lint, build, request regression tests, and runtime dependency audit.

For a fresh local release check after installing dependencies:

npm run build
node --test tests/*.test.cjs
node scripts/prepare-release.cjs
npm --prefix .release-package run lint
npm --prefix .release-package run build
(cd .release-package && node --test tests/*.test.cjs && npm pack --dry-run)

The staging directory must not already exist. Only a version-matching v* tag triggers publication; PR and main builds validate without publishing.

Resources

• n8n Community Nodes Documentation
• Typecast API Docs

License

MIT