Quick Navigation & Studio Command Palette
Jump to Voiceover Studio, Skit Cloner, Plans, or Account Security
Anti-Abuse Firewall: Free 50-credit starter accounts use the Web Studio; any paid pack unlocks REST API, and Studio VIP unlocks MCP.
100% shared PostgreSQL credit wallet across Web Studio, REST API, and MCP. Failed upstream syntheses automatically refund 100% of reserved credits.
1) Generate your ctts_live_ key below -> 2) Call POST /api/v1/tts with text, voice_id & emotion -> 3) Receive ready-to-publish .MP3 URL + CapCut .SRT + WebVTT (.VTT) captions in one response.
50 Trial Credits (Web Only)
✓ Web Studio 7-emotion test + .SRT download
✕ API Key generation blocked (prevents bot abuse)
Lite / Creator Pro / PAYG ≥ HK$100
✓ Unlocks REST API (/api/v1/tts, /voices, /usage)
✓ Up to 3 active API keys · 30 requests/min
✕ Remote MCP Server (/api/mcp) locked
Studio VIP (HK$388/mo or HK$698 VIP Pack)
✓ Exclusive Remote MCP Server (/api/mcp) for Claude, Cursor & AI Agents
✓ REST API v1 + all 30 VIP voices · 60 req/min · 5 keys
API Key Vault
0 / 0 ActiveKeys use the ctts_live_ prefix and are stored strictly as SHA-256 hashes in PostgreSQL. Copy your secret immediately upon creation.
Sign in first to view your plan entitlement and generate API keys.
Sign In / RegisterNo API keys created yet.
Live /api/v1/tts Sandbox Runner
Paste your ctts_live_ key to run a real API synthesis against your wallet and inspect the .MP3 + .SRT JSON response.
Quickstart Integration: REST API v1 & Studio VIP MCP
All endpoints use clean CantoneseTTS voice IDs (canto_*, blend_*, clone_*) and return MP3 URL + CapCut .SRT captions.
List all Cantonese, Konglish, blend & cloned voice_ids
Check shared wallet balance & remaining characters
Convert written Chinese & HKD figures to spoken Cantonese
Synthesize 7-emotion MP3 + synced .SRT captions
curl -X POST https://cantonesetts.com/api/v1/tts \
-H "Authorization: Bearer ctts_live_your_secret_key_here" \
-H "Content-Type: application/json" \
-d '{
"text": "喂大家好呀！今日限時閃購低至 $198，撳下面條 Link 即刻鎖定優惠啦！",
"voice_id": "canto_yuki_ig",
"emotion": "happy",
"speed": 1.08,
"colloquialize": true
}'import requests
API_KEY = "ctts_live_your_secret_key_here"
resp = requests.post(
"https://cantonesetts.com/api/v1/tts",
headers={"Authorization": f"Bearer {API_KEY}"},
json={
"text": "唔該幫我 Check 下份 Proposal，聽日十點前覆返個客。",
"voice_id": "blend_boutique_queen",
"emotion": "happy",
"colloquialize": True,
},
timeout=30,
)
data = resp.json()
print("MP3 URL:", data["audio_url"])
print("Remaining chars:", data["standard_chars_remaining"])
print("CapCut SRT:\n", data["srt"])Public Voice Alias Catalog (voice_id)
5 VoicesPass any voice_id below to POST /api/v1/tts or synthesize_cantonese_tts. Any custom 10-second cloned voices on your account also appear automatically.
canto_yuki_igYuki Viral Reels GirlHigh-energy HK female voice built for IG Reels hooks.
canto_marcus_hostMarcus Broadcast HostAuthoritative Hong Kong male anchor for finance and corporate launches.
blend_boutique_queenMandy Boutique Queen BlendProprietary high-converting HK boutique owner voice.
canto_alan_konglishAlan Tech KonglishNatural Hong Kong Cantonese-English code-switching male voice.
blend_midnight_mysteryVictor Midnight Mystery (Studio VIP)👑 Studio VIPStudio VIP exclusive thriller and true-crime deep Cantonese storyteller.