GET
/v1/schemas/openai/chat/realtime/transcription_sessions
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace3f115c72cf761f250dffef5a1bd0e50d58f35e9e0b9415901622880fdbca3418{
"fetchedAt": 1793250606,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
5 properties · 0 required · 2 $defs| property | type | description | constraints |
|---|---|---|---|
| turn_detection | object | Configuration for turn detection. Can be set to `null` to turn off. Server VAD means that the model will detect the start and end of speech based on audio volume and respond at the end of user speech. | |
| input_audio_noise_reduction | object | Configuration for input audio noise reduction. This can be set to `null` to turn off. Noise reduction filters audio added to the input audio buffer before it is sent to VAD and the model. Filtering the audio can improve VAD and turn detection accuracy (reducin… | |
| input_audio_format | enum | The format of input audio. Options are `pcm16`, `g711_ulaw`, or `g711_alaw`. For `pcm16`, input audio must be 16-bit PCM at a 24kHz sample rate, single channel (mono), and little-endian byte order. | pcm16 | g711_ulaw | g711_alaw · default: "pcm16" |
| input_audio_transcription | AudioTranscription | Configuration for input audio transcription. The client can optionally set the language and prompt for transcription, these offer additional guidance to the transcription service. | |
| include | enum[] | The set of items to include in the transcription. Current available items are: `item.input_audio_transcription.logprobs` |
Types
2 $defsAudioTranscriptionobject
| model | string | enum | The model to use for transcription. Current options are `whisper-1`, `gpt-transcribe`, `gpt-live-transcribe`, `gpt-4o-mini-transcribe`, `gpt-4o-mini-transcribe-2025-12-15`, `gpt-4o-transcribe`, `gpt-4o-transcribe-diarize`, and `gpt-realtime-whisper`. Use `gpt-… | |
| language | string | The language of the input audio. Supplying the input language in [ISO-639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) (e.g. `en`) format will improve accuracy and latency. | |
| languages | string[] | Possible languages of the input audio, in [ISO-639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format. Supported by `gpt-transcribe` and `gpt-live-transcribe`. | items ≥ 1 |
| keywords | string[] | Words or phrases to guide transcription of the input audio. Supported by `gpt-transcribe` and `gpt-live-transcribe`. | |
| prompt | string | An optional text to guide the model's style or continue a previous audio segment. For `whisper-1`, the [prompt is a list of keywords](https://developers.openai.com/api/docs/guides/speech-to-text#prompting). For `gpt-4o-transcribe` models (excluding `gpt-4o-tra… | |
| delay | enum | Controls how long the model waits before emitting transcription text. Higher values can improve transcription accuracy at the cost of latency. Only supported with `gpt-realtime-whisper` in GA Realtime sessions. | minimal | low | medium | high | xhigh |
NoiseReductionTypeenum
Type of noise reduction. `near_field` is for close-talking microphones such as headphones, `far_field` is for far-field microphones such as laptop or conference room microphones.
near_field | far_field
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"openai","endpointId":"realtime/transcription_sessions","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}