Sign in

v3

latestOpenAPI 3.1.02026-08-0150254154.0 KB
speak > v1 > audio

Text to Speech transformation

Convert text into natural-sounding speech using Deepgram's TTS REST API

post/v1/speak

Query parameters

callbackstring

URL to which we'll make the callback request

callback_method'POST' | 'PUT'

HTTP method by which the callback request will be made

mip_opt_outboolean

Opts out requests from the Deepgram Model Improvement Program. Refer to our Docs for pricing impacts before setting this to true. https://dpgr.am/deepgram-mip

string
OR
string[]

Label your requests for the purpose of identification during usage reporting

'32000' | '48000'

Encoding - mp3(default). Supported bitrates - 32000, 48000(default) bps.

OR
number double
OR
number double

The bitrate of the audio in bits per second. Choose from predefined ranges or specific values based on the encoding type.

'none'

No container.

OR
'wav'

Encoding - linear16. Supported container - wav (default), or no container.

OR
'wav'

Encoding - mulaw. Supported container - wav (default), or no container.

OR
'wav'

Encoding - alaw. Supported container - wav (default), or no container.

OR
'ogg'

Encoding - opus. Supported container - ogg (default).

Container specifies the file format wrapper for the output audio. The available options depend on the encoding type.

'linear16'

Encoding - linear16. Uncompressed, high-quality audio format often used for telephony or audio processing.

OR
'flac'

Encoding - flac. Lossless audio format for high-quality compression.

OR
'mulaw'

Encoding - mulaw. Compressed audio format commonly used in telephony.

OR
'alaw'

Encoding - alaw. Similar to mulaw but used in international telephony.

OR
'mp3'

Encoding - mp3. Popular compressed audio format for music and streaming.

OR
'opus'

Encoding - opus. High-compression audio format optimized for real-time communications.

OR
'aac'

Encoding - aac. Advanced audio format offering better quality at smaller file sizes than mp3.

Encoding allows you to specify the expected encoding of your audio output

model'aura-angus-en' | 'aura-arcas-en' | 'aura-asteria-en' | 'aura-athena-en' | 'aura-helios-en' | 'aura-hera-en' | 'aura-luna-en' | 'aura-orion-en' | 'aura-orpheus-en' | 'aura-perseus-en' | 'aura-stella-en' | 'aura-zeus-en' | 'aura-2-amalthea-en' | 'aura-2-andromeda-en' | 'aura-2-apollo-en' | 'aura-2-arcas-en' | 'aura-2-aries-en' | 'aura-2-asteria-en' | 'aura-2-athena-en' | 'aura-2-atlas-en' | 'aura-2-aurora-en' | 'aura-2-callista-en' | 'aura-2-cora-en' | 'aura-2-cordelia-en' | 'aura-2-delia-en' | 'aura-2-draco-en' | 'aura-2-electra-en' | 'aura-2-harmonia-en' | 'aura-2-helena-en' | 'aura-2-hera-en' | 'aura-2-hermes-en' | 'aura-2-hyperion-en' | 'aura-2-iris-en' | 'aura-2-janus-en' | 'aura-2-juno-en' | 'aura-2-jupiter-en' | 'aura-2-luna-en' | 'aura-2-mars-en' | 'aura-2-minerva-en' | 'aura-2-neptune-en' | 'aura-2-odysseus-en' | 'aura-2-ophelia-en' | 'aura-2-orion-en' | 'aura-2-orpheus-en' | 'aura-2-pandora-en' | 'aura-2-phoebe-en' | 'aura-2-pluto-en' | 'aura-2-saturn-en' | 'aura-2-selene-en' | 'aura-2-thalia-en' | 'aura-2-theia-en' | 'aura-2-vesta-en' | 'aura-2-zeus-en' | 'aura-2-agustina-es' | 'aura-2-alvaro-es' | 'aura-2-antonia-es' | 'aura-2-aquila-es' | 'aura-2-carina-es' | 'aura-2-celeste-es' | 'aura-2-diana-es' | 'aura-2-estrella-es' | 'aura-2-gloria-es' | 'aura-2-javier-es' | 'aura-2-luciano-es' | 'aura-2-nestor-es' | 'aura-2-olivia-es' | 'aura-2-selena-es' | 'aura-2-silvia-es' | 'aura-2-sirio-es' | 'aura-2-valerio-es' | 'aura-2-aurelia-de' | 'aura-2-elara-de' | 'aura-2-fabian-de' | 'aura-2-julius-de' | 'aura-2-kara-de' | 'aura-2-lara-de' | 'aura-2-viktoria-de' | 'aura-2-beatrix-nl' | 'aura-2-cornelia-nl' | 'aura-2-daphne-nl' | 'aura-2-hestia-nl' | 'aura-2-lars-nl' | 'aura-2-leda-nl' | 'aura-2-rhea-nl' | 'aura-2-roman-nl' | 'aura-2-sander-nl' | 'aura-2-agathe-fr' | 'aura-2-hector-fr' | 'aura-2-cesare-it' | 'aura-2-cinzia-it' | 'aura-2-demetra-it' | 'aura-2-dionisio-it' | 'aura-2-elio-it' | 'aura-2-flavio-it' | 'aura-2-livia-it' | 'aura-2-maia-it' | 'aura-2-melia-it' | 'aura-2-perseo-it' | 'aura-2-ama-ja' | 'aura-2-ebisu-ja' | 'aura-2-fujin-ja' | 'aura-2-izanami-ja' | 'aura-2-uzume-ja'

AI model used to process submitted text

'8000' | '16000' | '24000' | '32000' | '48000'

Encoding - linear16. Supported sample rates - 8000, 16000, 24000, 32000, 48000 Hz.

OR
'8000' | '16000'

Encoding - mulaw. Supported sample rates - 8000, 16000 Hz.

OR
'8000' | '16000'

Encoding - alaw. Supported sample rates - 8000, 16000 Hz.

OR
'22050'

Encoding - mp3. Sample rate is fixed and not configurable (22050 Hz).

OR
'48000'

Encoding - opus. Sample rate is fixed at 48000 Hz.

Sample Rate specifies the sample rate for the output audio. Based on the encoding, different sample rates are supported. For some encodings, the sample rate is not configurable

speednumber double

Speaking rate multiplier that adjusts the pace of generated speech while preserving natural prosody and voice quality. Not yet supported in all languages.

Headers

Authorizationstring required

Use Authorization: Token <API_KEY> Example: Authorization: Token 12345abcdef

Request body

textstring required

The text content to be converted to speech

Response

Successful text-to-speech transformation

SpeakV1AudioGenerateResponse200 required

Empty response body