GET
/v1/schemas/openai/chat/realtime/sessions?kind=output
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace3f115c72cf761f250dffef5a1bd0e50d58f35e9e0b9415901622880fdbca3418{
"fetchedAt": 1793250606,
"extractorVersion": "1",
"verifiedAt": null
} |
Response body
13 properties · 0 required · 5 $defs| property | type | description | constraints |
|---|---|---|---|
| id | string | Unique identifier for the session that looks like `sess_1234567890abcdef`. | |
| object | string | The object type. Always `realtime.session`. | |
| expires_at | integer | Expiration timestamp for the session, in seconds since epoch. | format: unixtime |
| include | enum[] | Additional fields to include in server outputs. - `item.input_audio_transcription.logprobs`: Include logprobs for input audio transcription. | |
| model | string | The Realtime model used for this session. | |
| output_modalities | any | The set of modalities the model can respond with. To disable audio, set this to ["text"]. | |
| instructions | string | The default system instructions (i.e. system message) prepended to model calls. This field allows the client to guide the model on desired responses. The model can be instructed on response content and format, (e.g. "be extremely succinct", "act friendly", "he… | |
| audio | object | Configuration for input and output audio for the session. | |
| tracing | enum | Tracing Configuration | Configuration options for tracing. Set to null to disable tracing. Once tracing is enabled for a session, the configuration cannot be modified. | |
| 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. | |
| tools | RealtimeFunctionTool[] | Tools (functions) available to the model. | |
| tool_choice | string | How the model chooses tools. Options are `auto`, `none`, `required`, or specify a function. | |
| max_output_tokens | integer | enum | Maximum number of output tokens for a single assistant response, inclusive of tool calls. Provide an integer between 1 and 4096 to limit output tokens, or `inf` for the maximum available tokens for a given model. Defaults to `inf`. |
Types
5 $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
RealtimeAudioFormatsPCM audio format | PCMU audio format | PCMA audio format
RealtimeFunctionToolobject
| type | enum | The type of the tool, i.e. `function`. | function |
| name | string | The name of the function. | |
| description | string | The description of the function, including guidance on when and how to call it, and guidance about what to tell the user when calling (if anything). | |
| parameters | object | Parameters of the function in JSON Schema. |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"openai","endpointId":"realtime/sessions","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}