廣東話配音 REST API 實戰教學：用 Python 與 n8n 自動批次生成 Reels 旁白連 .SRT/.VTT 雙字幕
唔使逐條片人手撳掣下載！詳解點樣用 CantoneseTTS.com 嘅 /api/v1/tts 端點，一次 HTTP 請求同步拎齊口語化廣東話 MP3、CapCut .SRT 同網頁 .VTT 字幕，並共用同一個原子字數錢包。
免除剪片同網頁上字幕二次轉檔
365 日有效 · 與網頁配音台共用錢包
PostgreSQL 預留帳本零白扣風險
要自動化批量生產地道香港廣東話旁白，可使用 CantoneseTTS.com 嘅 POST /api/v1/tts REST API。任何已課金帳號（低至 HK$100 一萬字包）均可喺後台生成 Bearer ctts_live_ 金鑰，單次請求同步完成「書面語轉香港口語 + 7 種情緒合成 + .MP3 連結 + .SRT 與 .VTT 雙格式字幕」，並享有上游超時 100% 自動退點保障。
即場試聽對比：機械平淡讀稿 vs 調校情緒後成品
「喂大家好呀！今日限時閃購低至 $198，撳下面條 Link 即刻鎖定優惠啦！」
點解直接駁底層語音模型做香港自動化頻道成日撞板？
好多經營無露面（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 步自動化工作流配置重點
為咗防止自動化註冊機惡意狂刷免費體驗額，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）
Q1. 網頁配音室買咗嘅 5 萬字或 10 萬字包，可唔可以同時喺 REST API 扣用？
100% 共用同一個 PostgreSQL 字數錢包！你唔需要分開買兩邊額度，喺網頁撳又得、用 Python 或 n8n 跑 API 又得，每次回傳都會清楚列明 `standard_chars_remaining` 剩餘字數。
Q2. 如果夜晚跑 Batch 批次腳本遇到網絡超時，會唔會白扣我錢包點數？
唔會。後端採用預留（Reserve）與結算（Settle）兩段式交易；一旦上游合成失敗或超時，系統會即時觸發 `release_job_refund` 100% 原數退回預扣點數。