Pronunciation, programmable.

Pro

One proposed API for IPA, bulk pronunciation and voice.

Authentication

Send your API key in the X-API-Key header over HTTPS. Keep keys on your server, never in client-side code or public repositories.

POST /v1/transcribe
X-API-Key: YOUR_API_KEY
Content-Type: application/json

POST /v1/transcribe

Convert English text to IPA and easy respelling.

Request

{
  "text": "hello",
  "accent": "us"
}

200 response

{
  "ipa": "həˈloʊ",
  "respelling": "huh-LOH",
  "accent": "us",
  "characters": 5
}

POST /v1/bulk

Transcribe up to 100 text items in one request.

Request

{
  "items": [
    "hello",
    "world"
  ],
  "accent": "uk"
}

200 response

{
  "results": [
    {
      "text": "hello",
      "ipa": "həˈləʊ",
      "respelling": "huh-LOH"
    },
    {
      "text": "world",
      "ipa": "wɜːld",
      "respelling": "wurld"
    }
  ],
  "characters": 10
}

POST /v1/audio

Generate an MP3 pronunciation clip. Proposed audio allowance and pricing will be announced before launch.

Request

{
  "text": "hello",
  "accent": "au",
  "format": "mp3"
}

200 response

{
  "audio_url": "https://example.invalid/clip.mp3",
  "expires_in": 3600,
  "characters": 5
}

Supported accents

  • us — American English (default)
  • uk — British English
  • au — Australian English

Proposed rate limits & errors

60 requests per minute per key; 5,000 characters per text; 100 items and 50,000 characters total per bulk request. All text items count toward usage. Responses will include rate-limit headers; a 429 response includes Retry-After. Limits are draft and may change before launch.

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Retry after the indicated delay."
  }
}

400: invalid payload or accent · 401: missing/invalid key · 413: payload too large · 429: rate limit · 500: service error.

Proposed transcription usage pricing

Monthly volumePrice
First 10,000 charactersFree
Additional characters$1 per 100,000 characters
Audio generationTo be announced

Usage is separate from Pro and Teacher. No API charges, metering or payments are active today.

Compare plans