GET
/v1/schemas/together/audio/v1%2Faudio%2Ftranscriptions
Accept:
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. |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"together","endpointId":"v1/audio/transcriptions","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}