Skip to main content
Deepgram only. Returns 400 if used with other models.
Pass-through to Deepgram’s pre-recorded API query parameters. Every key-value pair in model_config is forwarded directly — Telnyx does not validate individual options.

​
Commonly Used Options

OptionTypeDescription
smart_formatbooleanCapitalization, punctuation, dates, numbers, currency
punctuatebooleanAdd punctuation
diarizebooleanSpeaker identification. Adds speakers array to verbose_json segments.
utterancebooleanSegment transcript into utterances
numeralsbooleanConvert spoken numbers to digits
languagestringOverride language. Top-level language param takes precedence.

​
Example

curl -X POST https://api.telnyx.com/v2/ai/audio/transcriptions \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -F "file=@call-recording.mp3" \
  -F "model=deepgram/nova-3" \
  -F "response_format=verbose_json" \
  -F 'model_config={"smart_format": true, "diarize": true, "punctuate": true}'
model_config can be sent as a JSON string in the multipart form field. The server parses it before forwarding.

​
Unvalidated Pass-Through

Any Deepgram query parameter can be passed. If Deepgram adds new options, they work immediately without a Telnyx API update. Conversely, invalid keys are forwarded and may cause Deepgram to return an error. Refer to Deepgram’s API reference for the full list of supported parameters.