GET
/v1/schemas/together/audio/audio/transcriptions
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace468edbdc879c48f500ca284270663ccc30cd83aee57a4e6a4e7a5bc04603b543{
"fetchedAt": 1786771359,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
10 properties · 1 required · 2 $defs| property | type | description | constraints |
|---|---|---|---|
| file* | string | string | Audio file upload or public HTTP/HTTPS URL. Supported formats: .wav, .mp3, .m4a, .webm, .flac, .ogg, .opus, .aac. Maximum duration 4 hours; longer audio is rejected with `audio_too_long`. Binary uploads are additionally capped at 80 MB (HTTP 413); URL-fetched … | |
| model | enum | Model to use for transcription | openai/whisper-large-v3 · default: "openai/whisper-large-v3" |
| language | string | Optional ISO 639-1 language code. If `auto` is provided, language is auto-detected. | default: "en" |
| prompt | string | 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 | enum | The format of the response | json | verbose_json · default: "json" |
| temperature | number | Sampling temperature between 0.0 and 1.0 | 0 ≤ n ≤ 1 · default: 0 |
| timestamp_granularities | enum | enum[] | Controls level of timestamp detail in verbose_json. Only used when response_format is verbose_json. Can be a single granularity or an array to get multiple levels. | default: "segment" |
| diarize | boolean | 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 co… | default: false |
| min_speakers | integer | Minimum number of speakers expected in the audio. Used to improve diarization accuracy when the approximate number of speakers is known. | |
| max_speakers | integer | Maximum number of speakers expected in the audio. Used to improve diarization accuracy when the approximate number of speakers is known. |
Types
2 $defsAudioFileBinarystring
Audio file uploaded as binary. Maximum upload size 80 MB (requests above this are rejected with HTTP 413). For larger payloads, host the file and submit a URL instead.
format: binary
AudioFileUrlstring
Public HTTPS URL the server fetches the audio from. Server-side fetch limit is 1 GB; downloads exceeding the cap fail with `file_too_large`.
format: uri
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"together","endpointId":"audio/transcriptions","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}