---
title_zh: "廣東話配音 REST API 實戰教學：用 Python 與 n8n 自動批次生成 Reels 旁白連 .SRT/.VTT 雙字幕"
title_en: "Cantonese TTS REST API Tutorial: Batch-Generate Reels Voiceovers with .SRT & .VTT in Python and n8n"
canonical_zh: "https://cantonesetts.com/zh-HK/blog/cantonese-tts-api-python-n8n-faceless-automation"
canonical_en: "https://cantonesetts.com/en/blog/cantonese-tts-api-python-n8n-faceless-automation"
category: "Spoken HK, Konglish & SRT"
target_keyword: "廣東話配音 API"
published_at: "2026-11-15"
updated_at: "2026-11-15"
publisher: "CantoneseTTS.com HK Acoustic & Conversion Lab"
---

# 廣東話配音 REST API 實戰教學：用 Python 與 n8n 自動批次生成 Reels 旁白連 .SRT/.VTT 雙字幕

> **TL;DR (ZH):** 要自動化批量生產地道香港廣東話旁白，可使用 CantoneseTTS.com 嘅 POST /api/v1/tts REST API。任何已課金帳號（低至 HK$100 一萬字包）均可喺後台生成 Bearer ctts_live_ 金鑰，單次請求同步完成「書面語轉香港口語 + 7 種情緒合成 + .MP3 連結 + .SRT 與 .VTT 雙格式字幕」，並享有上游超時 100% 自動退點保障。

> **TL;DR (EN):** To automate authentic Hong Kong Cantonese voiceovers at scale, call POST https://cantonesetts.com/api/v1/tts with a Bearer ctts_live_ API key (unlocked on any paid plan starting at HK$100 / US$13). One request normalizes written Chinese into spoken HK Cantonese and returns the MP3 URL, frame-synced .SRT, and HTML5 .VTT captions backed by 100% atomic auto-refund on upstream failure.

## Case Study Metrics

- **單次 API 回傳格式**: MP3 + SRT + VTT (免除剪片同網頁上字幕二次轉檔)
- **API 解鎖最低門檻**: HK$100 / 1 萬字 (365 日有效 · 與網頁配音台共用錢包)
- **異常退點保障**: 100% 原子退回 (PostgreSQL 預留帳本零白扣風險)

## Studio Cantonese Audio Demo

- Sample Script: 「喂大家好呀！今日限時閃購低至 $198，撳下面條 Link 即刻鎖定優惠啦！」
- Control Audio (未開 colloquialize：直接照讀書面語與阿拉伯數字): https://cantonesetts.com/audio/demos/emo_neutral.mp3
- Studio Directed Audio (API colloquialize=true + Happy 情緒實測輸出): https://cantonesetts.com/audio/demos/showcase_ig_flashsale.mp3
- Try Live in Studio: https://cantonesetts.com/zh-HK/tts?voice=Cantonese_CuteGirl&emotion=happy

## 點解直接駁底層語音模型做香港自動化頻道成日撞板？

**核心要點：** 一般國際或底層語音 API 只負責將字轉聲，唔識自動將「這個 $198 的優惠」轉成「呢個一百九十八蚊嘅優惠」，亦唔會連埋對齊時間軸嘅 .SRT 字幕回傳。

好多經營無露面（Faceless）財經新聞台、樓盤資訊台或者網店商品目錄嘅工程師，一開始都會試下用 Python 直接駁國際通用語音 API。結果跑出嚟第一條片就會發現兩個致命問題：第一，RSS 或商品庫入面嘅文案全部係書面語（「他們今天購買即可享有折扣」），直接合成出嚟陣機械味極濃；第二，拎到純 MP3 之後，仲要自己再搭一套語音轉文字（STT）去計時間軸出字幕，既嘥伺服器成本又成日聽錯廣東話同音字。

CantoneseTTS.com 嘅 `/api/v1/tts` 專為解決呢條斷裂鏈而設：只要喺 JSON Body 加上 `"colloquialize": true`，後端會先將書面語、港幣銀碼同日期正規化成地道香港口語，再交由指定聲線同情緒合成，最後直接計準句讀時間軸，一次過回傳 `audio_url`、`srt` 同 `vtt` 三樣成品。

- 免自建 STT 對軸工序：直接根據正規化後嘅真實港式字句生成零錯字 .SRT 與 .VTT。
- 封裝公開聲線代號（如 `canto_yuki_ig`、`blend_boutique_queen`），支援自訂聲紋 `clone_*`。

## n8n / Python 3 步自動化工作流配置重點

**核心要點：** 喺 `/developer` 生成 `ctts_live_` 金鑰 -> 設定 `Authorization: Bearer` Header -> 讀取回傳嘅 `audio_url` 同 `srt` 直接餵入 FFmpeg 或剪片模板。

為咗防止自動化註冊機惡意狂刷免費體驗額，REST API 採用「真卡課金防火牆」設計：免費註冊 50 點只供網頁工作台試玩；只要購買任何付費方案（包括最平 HK$100 一萬標準字一年期按量包），後台 `/zh-HK/developer` 即刻解鎖金鑰管理。

你可以隨時開啟 `https://cantonesetts.com/api-docs.md` 複製完整 Python、TypeScript 同 n8n HTTP Request 節點設定表，或者將 `https://cantonesetts.com/openapi.json` 匯入 Postman 同 Hoppscotch 即場測試。

## 常見問題 (FAQ)

### 網頁配音室買咗嘅 5 萬字或 10 萬字包，可唔可以同時喺 REST API 扣用？
100% 共用同一個 PostgreSQL 字數錢包！你唔需要分開買兩邊額度，喺網頁撳又得、用 Python 或 n8n 跑 API 又得，每次回傳都會清楚列明 `standard_chars_remaining` 剩餘字數。

### 如果夜晚跑 Batch 批次腳本遇到網絡超時，會唔會白扣我錢包點數？
唔會。後端採用預留（Reserve）與結算（Settle）兩段式交易；一旦上游合成失敗或超時，系統會即時觸發 `release_job_refund` 100% 原數退回預扣點數。

## Verified Sources (E-E-A-T)

- [CantoneseTTS.com REST API & MCP Quickstart (api-docs.md)](https://cantonesetts.com/api-docs.md)
- [OpenAPI Initiative: OpenAPI Specification v3.1.0](https://spec.openapis.org/oas/v3.1.0)
- [W3C Recommendation: WebVTT (The Web Video Text Tracks Format)](https://www.w3.org/TR/webvtt1/)