Skip to main content
POST
Stream synthesized speech

Authorizations

Authorization
string
header
required

API key passed as an Authorization Bearer token: Authorization: Bearer YOUR_API_KEY

Body

application/json
model
string
required

Must be in the environment's speech catalog. An unlisted model returns 400 without dispatching a synthesis.

Example:

"deepgram/aura-2"

input
string
required

Text to synthesize. Bounded by the model's per-character limit (counted in Unicode runes).

voice
string
required

Model-specific, namespaced voice id. Must be allowlisted for the model.

Example:

"aura-2-thalia-en"

response_format
string
default:mp3

Audio format. Omitted defaults to mp3. Allowed values are per-model (e.g. mp3, pcm).

Example:

"mp3"

speed
number

Playback speed. Accepted only for models that declare support; otherwise 400.

Required range: 0.25 <= x <= 4
instructions
string

Steering instructions. Accepted only for models that declare support; otherwise 400.

stream_format
enum<string>

Only raw audio streaming is supported. sse is rejected with 400.

Available options:
audio

Response

Raw audio byte stream. Bytes are forwarded progressively as the provider synthesizes them; the content type is the negotiated format (audio/mpeg or audio/pcm;rate=…;channels=…).

The response is of type file.

Last modified on July 27, 2026