# tts.cx — Text-to-Speech for Agents
# Version: 1.1.69
# https://tts.cx

> Production-grade text-to-speech built for coding agents and apps.
> One API key, one call — natural voices in seconds.

## Authentication
All requests require: Authorization: Bearer <API_KEY>
Get a key (instant, no card up front):
  CLI:  npm install -g abz && abz signup my-app --local
  API:  POST /api/signup {"tenantId":"my-app"}
Key format: abz_{tenantId}_{hex}

## Quick Reference
| Action              | Method | Endpoint                        |
|---------------------|--------|---------------------------------|
| Sign up             | POST   | /api/signup                     |
| Synthesize          | POST   | /api/v1/tts/synthesize          |
| Synthesize (stream) | POST   | /api/v1/tts/synthesize/stream   |
| List voices         | GET    | /api/v1/tts/voices              |
| Service status      | GET    | /api/v1/tts/status              |
| Usage               | GET    | /api/v1/tts/usage               |
| Liveness            | GET    | /health                         |

## Synthesize
POST /api/v1/tts/synthesize
Body:
  {
    "text":   "Hello world",        // required, up to 5000 chars
    "voice":  "ava",                // optional, default "ava"
    "agentRole": "cfo",             // optional, overrides voice (see Agent roles)
    "format": "mp3"                 // optional: wav (default), wav16k, mp3
  }
Response:
  {
    "success": true,
    "audio":   "<base64>",
    "format":  "mp3",
    "voice":   "ava"
  }

Streaming: POST /api/v1/tts/synthesize/stream returns a continuous audio/mpeg
stream (chunked). First audio arrives as soon as the opening phrase is ready.

## Agent roles
Pass agentRole to drop in a boardroom voice without picking a name:
  cfo · cto · cmo · cco · cso · clo

## Voices
21 signature voices — male & female, American & British. Pick with "voice".
American female: ava (warm, professional · default), bianca (confident),
  nadia (calm, clear), vera (energetic), celeste (bright), alba (neutral),
  jade (friendly), rae (smooth), sana (professional)
American male: marcus (warm, authoritative), piers (young, eager),
  fenn (deep, serious), leo (clear), enzo (balanced), errol (professional),
  aldo (steady), orin (commanding), kris (jolly, mature)
British: eliza (elegant, female), fitz (scholarly, male), giles (formal, male)
Full list with metadata: GET /api/v1/tts/voices

## Limits
- Up to 5000 characters per request
- Monthly character quota per plan (429 when exceeded; see /api/v1/tts/usage)

## Documentation
- Quickstart: https://tts.cx/docs/quickstart.html
- Agent guides: https://tts.cx/docs/quickstart/claude-code.html
- This file: https://tts.cx/llms.txt