README.md

metadata

title: Chatterbox TTS API
emoji: 🗣️
colorFrom: indigo
colorTo: purple
sdk: docker
app_port: 7860
pinned: false

Chatterbox TTS API

CPU-only FastAPI wrapper around ResembleAI/chatterbox multilingual TTS.

Setup

Space → Settings → Variables and secrets → add secret API_KEY.

Usage

curl -X POST https://<user>-<space>.hf.space/tts \
  -H "x-api-key: $API_KEY" -H "content-type: application/json" \
  -d '{"text": "Hello there", "lang": "en"}'
# {"url": "https://<user>-<space>.hf.space/audio/<uuid>.wav", "lang": "en"}

Then curl -O <url> — the download endpoint is public (unguessable uuid).

Params: text (required, ≤1000 chars), lang (default en), exaggeration (0–2), cfg_weight (0–1).

Output is 24kHz mono WAV and always carries Resemble's Perth watermark. Defaults suit most prompts; for more expressive reads the model card suggests cfg_weight 0.3 with exaggeration ~0.7. Caveat: upstream generate() hardcodes max_new_tokens=1000 (40s of audio), so text beyond roughly 600-700 chars is silently truncated. Supported langs: ar, da, de, el, en, es, fi, fr, he, hi, it, ja, ko, ms, nl, no, pl, pt, ru, sv, sw, tr, zh.

Notes

• First request downloads the model (~1–2 min); CPU synthesis takes roughly 10–40s per sentence. Free Spaces sleep when idle, so the first call after a wake is slow.
• Audio lives on the ephemeral container disk — links die on restart. Add S3/Blob upload if you need durable URLs.