# Speech — TTS and ASR endpoints

All on irv-ml1 unless noted. Every one is FastAPI: **`GET /openapi.json` is the live
contract**, `/health` is the liveness probe.

## TTS

| service | endpoint | what it is |
|---|---|---|
| **Breeze-TTS-2** | `http://irv-ml1.nh3.internal:8204` | clone + direction, **fleet primary** |
| TTS fleet gateway | `http://irv-ml1.nh3.internal:8198` | switchboard; engines sit behind it |
| Chatterbox Fast | `http://irv-ml1.nh3.internal:8197` | streaming, sub-second first-audio — the live-chat front end |
| dots.tts | `http://irv-ml1.nh3.internal:8202` | continuous-AR 48 kHz zero-shot clone |
| Kokoro | `http://irv-ml1.nh3.internal:8193` | low-latency English, streaming |

**Breeze** (`/v1/voices`, `/v1/voices/detail`, `/v1/audio/speech`, `/v1/audio/design`)
— `/v1/voices` matches dots byte-for-byte so they are drop-in swappable;
`/v1/voices/detail` exposes the registry with its directions visible.

**Gateway** (`/v1/audio/speech`, `/v1/voices`) is also reachable through LiteLLM as
the `ext-tts` alias. Voices: donut / emmie / glados / miranda / sindra plus emotion
variants, or the OpenAI aliases nova / alloy. ⚠ **An unknown voice 404s and can trip
the router cooldown** — list voices first.

## ASR

| service | endpoint | what it is |
|---|---|---|
| Speaches | `http://irv-ml1.nh3.internal:8204` | OpenAI-compatible faster-whisper, `verbose_json` |
| Parakeet | `http://10.251.50.54:8300` | Parakeet-TDT via sherpa-onnx (fv-ml1 GPU 3) |
| Scriberr | `http://10.250.50.54:8080` | transcription + diarization UI (ana-ml2 GPU 1) |

## Traps

- **OmniVoice-style diffusion TTS has a TTFA floor** — roughly fixed per-call cost,
  ~0.7 s first-audio, real RTF 2.8–5.6× (not the advertised 40×). Chatterbox-fast
  stays the live-chat front end for that reason.
- **Never expose repetition-penalty dials on Zonos-lineage engines** — it is a silence
  footgun.
- Several engines listed on Homepage under *AI - Dormant* are down by design and take
  ~90 s to respin. Check `/health` before assuming a service is broken.