For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Synthesize a complete block of text into a single audio response using Deepgram’s Flux TTS batch (REST) API. Use this for pre-rendering fixed audio (IVR prompts, notifications, narration) where the whole text is known up front and you don’t need incremental playback or interruption.
Authentication
AuthorizationToken
Use Authorization: Token <API_KEY>
Example: Authorization: Token 12345abcdef
OR
AuthorizationBearer
Use Authorization: Bearer <JWT>
Example: Authorization: Bearer eyJhbGciOiJ...
Query parameters
callbackstringOptional
URL to which we'll make the callback request
callback_methodenumOptionalDefaults to POST
HTTP method by which the callback request will be made
Allowed values:
mip_opt_outbooleanOptionalDefaults to false
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
tagstring or list of stringsOptional
Label your requests for the purpose of identification during usage reporting
bit_rateenum or integerOptionalDefaults to 48000
The bitrate of the audio in bits per second. Choose from predefined ranges or specific values based on the encoding type.
containerenumOptionalDefaults to wav
Container specifies the file format wrapper for the output audio. The available options depend on the encoding type.
encodingenumOptionalDefaults to mp3
Encoding allows you to specify the expected encoding of your audio output
modelstringRequired
Flux TTS model used to synthesize the submitted text, in the form flux-{voice}-{language} (for example, flux-alexis-en). Required; unlike the v1 (Aura) endpoint there is no default and only flux models are accepted. English-only at launch.
sample_rateenumOptionalDefaults to 24000
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
priorityenumOptional
Processing priority for asynchronous (callback) requests. The only supported value is low.
Allowed values:
Request
Transform text to speech
textstringRequired
The text content to be converted to speech. The server normalizes and preprocesses the text (e.g. stripping inline controls) before synthesis.
Response
Returns the synthesized audio in the requested encoding as a binary stream. When a `callback` URL is supplied, the request is processed asynchronously and the response body is instead a JSON acknowledgement (Content-Type `application/json`) of the form {"request_id": "..."}, with the audio delivered to the callback URL. Because this endpoint is typed as a binary audio stream, SDK callers that set `callback` receive this JSON acknowledgement through the audio byte iterator as raw bytes and must join the chunks and parse `request_id` themselves.
request_idstringformat: "uuid"
Unique identifier for tracking the asynchronous request
Errors
400
Bad Request Error
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
Returns the synthesized audio in the requested encoding as a binary stream. When a callback URL is supplied, the request is processed asynchronously and the response body is instead a JSON acknowledgement (Content-Type application/json) of the form {“request_id”: ”…”}, with the audio delivered to the callback URL. Because this endpoint is typed as a binary audio stream, SDK callers that set callback receive this JSON acknowledgement through the audio byte iterator as raw bytes and must join the chunks and parse request_id themselves.
