Text-to-Speech API

View as Markdown

The Text-to-Speech (TTS) API converts plain text into synthesized speech. Fast mode accepts the complete text in one HTTPS POST and streams audio in the same response, so your application can start playback while receiving it.

Use the TTS API for interactive voice response systems, notifications, accessibility experiences, and short-form narration.

Key features

  • Converts up to 4,000 characters of plain text per request
  • Streams audio in the response, so playback can start before synthesis finishes
  • Offers ten voices
  • Controls speaking speed and volume
  • Returns raw 44.1 kHz mono PCM audio

How it works

  1. Get AI Services credentials.
  2. Send the text in the input field to POST /aiservices/tts/synthesize.
  3. Optionally set voice, speed, volume, and response_format in the same JSON object.
  4. Read the response body as raw PCM audio until the stream ends.

For request fields, examples, and error handling, see Fast mode.

Language and voices

The API supports US English (en-US) input. There is no language field, and a voice's accent doesn't add support for other input languages.

Set voice to one of these ten voice IDs. The default is jenna.

VoiceVoice IDAccentCharacter
AlexalexAmerican EnglishCharming and friendly
ArielarielAmerican EnglishProfessional and clear
AvaavaAmerican EnglishCalm and empathetic
BrookebrookeAmerican EnglishCalm and professional
HazelhazelAmerican EnglishEnthusiastic and warm
JennajennaAmerican EnglishClear and smooth
MarkmarkAmerican EnglishProfessional and empathetic
ReidreidAmerican EnglishCalm and crisp
ScottscottAmerican EnglishFriendly and deep
TonytonyBritish EnglishCharming and eloquent

Voice IDs are case-insensitive. An unsupported voice returns 400 UNSUPPORTED_VOICE; the service never substitutes another voice.

Audio format and limits

SettingValue
Response formatpcm_44100
EncodingSigned 16-bit little-endian PCM
Sample rate44,100 Hz
ChannelsMono
ContainerNone; no WAV or RIFF header
Maximum input length4,000 Unicode code points after JSON decoding
Maximum request body32 KiB (32,768 bytes)

The API accepts plain text only. It doesn't support SSML, streaming text input, batch synthesis, model selection, or other output formats.

Resources

AI Services are part of the Zoom Build platform. Use Zoom.ai  to discover, purchase, build with, and manage AI Services products. You can also create projects, get credentials, start a free trial, purchase a plan, and monitor usage.