Description

🔊 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": "1n00:00:00,390 --> 00:00:02,220nสวัสดีตอนเช้าn",
    "current_point": 509,
    "currentmonthlypoint": 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