Pronunciation REST API
Integrate text-to-speech audio streams, regional voice accents, and phonetic dictionary lookups directly into your web or mobile applications.
Per-IP sliding window rate limiting keeps service response times fast and consistent.
`POST /api/v1/pronunciations` returns raw `audio/mpeg` binary audio directly.
Full support for US, UK, AU, IN English, Spanish, French, German, Japanese, Korean & Hindi.
/api/v1/pronunciationsSynthesizes high-quality neural voice speech for any text string, returning an audio binary payload ready for instant web or mobile playback.
Request Parameters (JSON)
| Field | Type | Required | Description |
|---|---|---|---|
| text | string | Yes | Text string to pronounce (1 to 300 chars). |
| language | string | Yes | Locale code e.g. en-US, en-GB, en-IN, fr-FR, hi-IN. |
| voice | string | Optional | Voice ID or gender e.g. female, male, aria, guy, sonia. |
| delivery | string | Optional | natural (default), careful, or quick. |
Code Examples
curl -X POST http://localhost:5000/api/v1/pronunciations \
-H 'Content-Type: application/json' \
-H 'Accept: audio/mpeg' \
-d '{
"text": "Worcestershire",
"language": "en-GB",
"voice": "sonia",
"delivery": "natural"
}' \
--output worcestershire.mp3/api/v1/dictionaryFetches dictionary senses, IPA phonetic notation, parts of speech, usage examples, and synonyms for a requested headword.
curl "http://localhost:5000/api/v1/dictionary?word=pronunciation&language=en"
Response Headers & Error Handling
Every response includes standard rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining) and TTS metadata (X-TTS-Provider, X-TTS-Voice). If rate limit is exceeded, HTTP status 429 Too Many Requests is returned.