🔊 n8n-BotnoiVoice

Plug-in to connect Botnoi Voice API to n8n — allowing easy use of Thai Text-to-Speech (TTS) and Subtitle Generation (Gensub) directly inside your n8n workflows.

📌 Requirements before starting

1. Install basic tools

• Git
• Node.js version 20+
• Recommended via nvm (Linux, Mac, WSL)
• For Windows, see Microsoft Docs
• Install n8n globally:

npm install -g n8n

🚀 How to use the plugin

✅ Install from npm (recommended)

1. Create a custom n8n extensions folder:

mkdir -p ~/.n8n/custom
cd ~/.n8n/custom
npm init -y

2. Install the plugin:

npm i n8n-nodes-botnoi-voice

3. Start n8n:

n8n start

💡 Once installed, search in n8n for Botnoi Voice or Botnoi Gensub nodes.

🛠️ Install locally (if cloning repo)

1. Clone and install dependencies:

git clone https://github.com/phoovadetnoobdev/n8n-nodes-botnoi-voice
cd n8n-nodes-botnoi-voice
npm install

2. Build and link the plugin:

npm run build
npm link

3. Link to your n8n instance:

mkdir -p ~/.n8n/custom
cd ~/.n8n/custom
npm init -y
npm link n8n-nodes-botnoi-voice

4. Start n8n:

n8n start

🔐 Get API Key from Botnoi Voice

1. Visit https://voice.botnoi.ai/api-login
2. Login or sign up for a free account
3. Click Generate API Key
4. Copy the key for use in n8n

⚙️ Add API Key in n8n

1. Open Credentials tab in n8n
2. Create a new credential → Select Botnoi Voice
3. Paste your API key and test connection

✅ If the key is correct, it will show “Connection tested successfully”.

🗣️ Botnoi Voice (TTS)

Convert any text into natural-sounding speech in Thai, English, Japanese, Vietnamese, and more.

🧾 Usage Steps

1️⃣ Enter text to convert

• Add a Botnoi Voice node
• Enter text manually or use expression (e.g. {{ $json.output }})

2️⃣ Choose a speaker

• Over 300 voices available (Eva, Bo, Max, Alisa, etc.)

3️⃣ Select language

• Supports multiple languages — choose Thai, English, Japanese, etc.

4️⃣ Generate audio

• Click Execute Step → Output shows audio_url for playback or download.

🎧 Botnoi Gensub (Subtitle Generator)

Generate subtitles (SRT / JSON) automatically from any audio URL via Botnoi Voice API.

Ideal for creating Thai transcripts, podcast captions, or speech analytics.

🧩 Overview

• Supports URL input only
• Generates SRT or JSON subtitles
• Adjustable silence and duration segmentation
• Perfect with free hosting (e.g., EdgeOne Pages)

🧱 Example: Generate Subtitles from an Audio URL

✅ Step 1 — Upload audio

Use EdgeOne Pages Drop to host your file:

1. Go to https://pages.edgeone.ai/drop

2. Enter a temporary domain name

3. Upload your .mp3 or .wav

4. Copy the URL (e.g.)

   https://forward-cyan-xo4dfpu9q6.edgeone.app/Recording.mp3

✅ Step 2 — Configure Botnoi Gensub Node

| Field | Example | Description | | ------------------------------ | ----------------------------------------------------------- | ---------------------------------------- | | Credential to connect with | Botnoi account | Use your botnoiApi credential | | Audio URL | https://forward-cyan-xo4dfpu9q6.edgeone.app/Recording.mp3 | Publicly accessible file URL | | Max Duration (Seconds) | 10 | Max duration per subtitle segment | | Max Silence (Seconds) | 0.3 | Silence threshold before splitting lines | | Return SRT | Yes | Choose “Yes” to get SRT subtitle text | | Timeout (Ms) | 60000 | Request timeout (default 60s) |

✅ Step 3 — Execute and check result

{
  "message": "Transcribe successfully",
  "data": {
    "text": "1\n00:00:00,390 --> 00:00:02,220\nสวัสดีตอนเช้า\n",
    "current_point": 509,
    "current_monthly_point": 0,
    "used_points": 15
  }
}

Result (SRT format):

1
00:00:00,390 --> 00:00:02,220
สวัสดีตอนเช้า

⚙️ Tips

• Both nodes share the same credential botnoiApi
• Ensure your audio URL is publicly accessible (no login needed)
• Supported file formats: .mp3, .wav, .m4a
• Recommended audio length ≤ 60 seconds for best transcription quality

📚 References

• Botnoi Voice API Docs
• EdgeOne Pages Drop — free quick hosting
• n8n Node Developer Docs

🧑‍💻 Maintainer

Developed by Phoovadet Noobdev

📝 License

MIT License