Cantonese TTS REST API Tutorial: Batch-Generate Reels Voiceovers with .SRT & .VTT in Python and n8n
Automate Hong Kong Cantonese Reels and e-commerce product videos with one POST /api/v1/tts call returning MP3 audio, CapCut .SRT, and WebVTT captions from a shared atomic wallet.
免除剪片同網頁上字幕二次轉檔
365 日有效 · 與網頁配音台共用錢包
PostgreSQL 預留帳本零白扣風險
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.
Compare Flat Reading vs. Directed Cantonese Emotion
「喂大家好呀！今日限時閃購低至 $198，撳下面條 Link 即刻鎖定優惠啦！」
Why Raw Upstream TTS APIs Break on Hong Kong Automation Workflows
Teams building faceless Hong Kong news channels or automated e-commerce catalog videos quickly hit two bottlenecks with raw TTS APIs: upstream CMS copy is written in formal Standard Chinese rather than spoken Hong Kong Cantonese, and raw MP3 responses lack subtitle timestamps.
CantoneseTTS.com solves both inside a single POST /api/v1/tts call. Setting colloquialize: true converts written Chinese and HKD figures into natural Hong Kong speech before synthesis, then returns the hosted MP3 URL alongside ready-to-import SubRip (.srt) and WebVTT (.vtt) captions.
- Zero STT transcription typos: captions are built directly from normalized Cantonese script clauses.
- Clean public voice aliases (canto_yuki_ig, blend_boutique_queen) plus custom clone_* support.
3-Step Python & n8n Production Pipeline Setup
To prevent automated trial abuse while keeping entry friction low, REST API keys unlock immediately upon any paid purchase starting from the HK$100 (US$13) 10,000-character 365-day pack, sharing the exact same PostgreSQL credit balance as the web studio.
Copy ready-to-run cURL, Python, TypeScript, and n8n node templates directly from https://cantonesetts.com/api-docs.md or import https://cantonesetts.com/openapi.json into Postman.
Frequently Asked Questions
Q1. Does the REST API share the same character quota as the web voiceover studio?
Yes. Web Studio, REST API (/api/v1/*), and Studio VIP MCP (/api/mcp) all draw from one unified atomic PostgreSQL wallet.
Q2. Are credits refunded if an automated batch request hits an upstream timeout?
Yes. Credits use two-phase atomic reservation and are 100% automatically refunded if synthesis fails or times out.