Audio

Create audio transcription request

Changed on

Transcribes audio into text

post/v1/audio/transcriptions

Request

  • Base URL
    https://api.together.ai
  • URL
    https://api.together.ai/v1/audio/transcriptions
  • Auth
    HTTP bearer

Request body multipart/form-data

model'openai/whisper-large-v3'

Model to use for transcription

languagestring

Optional ISO 639-1 language code. If auto is provided, language is auto-detected.

promptstring

Optional text to bias decoding. Supported only on Whisper-family models (e.g. openai/whisper-large-v3). Other STT models (e.g. nvidia/parakeet-tdt-0.6b-v3) accept the field for API compatibility but ignore it.

response_format'json' | 'verbose_json'

The format of the response

temperaturenumber

Sampling temperature between 0.0 and 1.0

diarizeboolean

Whether to enable speaker diarization. When enabled, you will get the speaker id for each word in the transcription. In the response, in the words array, you will get the speaker id for each word. In addition, we also return the speaker_segments array which contains the speaker id for each speaker segment along with the start and end time of the segment along with all the words in the segment. <br> <br> For eg - ... "speaker_segments": [ "speaker_id": "SPEAKER_00", "start": 0, "end": 30.02, "words": [ { "id": 0, "word": "Tijana", "start": 0, "end": 11.475, "speaker_id": "SPEAKER_00" }, ...

min_speakersinteger

Minimum number of speakers expected in the audio. Used to improve diarization accuracy when the approximate number of speakers is known.

max_speakersinteger

Maximum number of speakers expected in the audio. Used to improve diarization accuracy when the approximate number of speakers is known.

Example request

{
  "language": "en"
}

Response

OK

OR

Example response

{
  "text": "Hello, world!"
}

Changes