Transcribe speech to text

POST 
/ai/audio/transcriptions

Transcribe speech to text. This endpoint is consistent with the OpenAI Transcription API and may be used with the OpenAI JS or Python SDK.

multipart/form-data

Body

required

file binary

The audio file object to transcribe, in one of these formats: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, or webm. File uploads are limited to 100 MB. Cannot be used together with file_url

file_url string

Link to audio file in one of these formats: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, or webm. Support for hosted files is limited to 100MB. Cannot be used together with file

model stringrequired

Possible values: [distil-whisper/distil-large-v2, openai/whisper-large-v3-turbo]

Default value: distil-whisper/distil-large-v2

ID of the model to use. distil-whisper/distil-large-v2 is lower latency but English-only. openai/whisper-large-v3-turbo is multi-lingual but slightly higher latency.

response_format string

Possible values: [json, verbose_json]

Default value: json

The format of the transcript output. Use verbose_json to take advantage of timestamps.

timestamp_granularities[] string

Possible values: [segment]

The timestamp granularities to populate for this transcription. response_format must be set verbose_json to use timestamp granularities. Currently segment is supported.

200: Successful Response

application/json

• Schema
• Example (from schema)

Schema

text stringrequired

The transcribed text for the audio file.

duration number

The duration of the audio file in seconds. This is only included if response_format is set to verbose_json.

segments

object[]

Segments of the transcribed text and their corresponding details. This is only included if response_format is set to verbose_json.

Array [

id numberrequired

Unique identifier of the segment.

start numberrequired

Start time of the segment in seconds.

end numberrequired

End time of the segment in seconds.

text stringrequired

Text content of the segment.

]

{
  "text": "string",
  "duration": 0,
  "segments": [
    {
      "id": 0,
      "start": 0,
      "end": 0,
      "text": "string"
    }
  ]
}

422: Validation Error

application/json

• Schema
• Example (from schema)

Schema

detail

object[]

Array [

loc

object[]

required

Array [

anyOf

• MOD1
• MOD2

string

integer

]

msg Message (string)required

type Error Type (string)required

]

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Request samples

• cURL

---

curl -L -X POST 'https://api.telnyx.com/v2/ai/audio/transcriptions' \
-H 'Content-Type: multipart/form-data' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

Response samples

• 200
• 422

---

{
  "text": "string",
  "duration": 0,
  "segments": [
    {
      "id": 0,
      "start": 0,
      "end": 0,
      "text": "string"
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}