Class SessionCreateResponse
-
- All Implemented Interfaces:
public final class SessionCreateResponse
A new Realtime session configuration, with an ephemeral key. Default TTL for keys is one minute.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description public final class
SessionCreateResponse.Builder
A builder for SessionCreateResponse.
public final class
SessionCreateResponse.ClientSecret
Ephemeral key returned by the API.
public final class
SessionCreateResponse.InputAudioTranscription
Configuration for input audio transcription, defaults to off and can be set to
null
to turn off once on. Input audio transcription is not native to the model, since the model consumes audio directly. Transcription runs asynchronously and should be treated as rough guidance rather than the representation understood by the model.public final class
SessionCreateResponse.MaxResponseOutputTokens
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 toinf
.public final class
SessionCreateResponse.Modality
public final class
SessionCreateResponse.Tool
public final class
SessionCreateResponse.Tracing
Configuration options for tracing. Set to null to disable tracing. Once tracing is enabled for a session, the configuration cannot be modified.
auto
will create a trace for the session with default values for the workflow name, group id, and metadata.public final class
SessionCreateResponse.TurnDetection
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.public final class
SessionCreateResponse.Voice
The voice the model uses to respond. Voice cannot be changed during the session once the model has responded with audio at least once. Current voice options are
alloy
,ash
,ballad
,coral
,echo
,sage
,shimmer
, andverse
.
-
Method Summary
Modifier and Type Method Description final SessionCreateResponse.ClientSecret
clientSecret()
Ephemeral key returned by the API. final Optional<String>
inputAudioFormat()
The format of input audio. final Optional<SessionCreateResponse.InputAudioTranscription>
inputAudioTranscription()
Configuration for input audio transcription, defaults to off and can be set to null
to turn off once on.final Optional<String>
instructions()
The default system instructions (i.e. final Optional<SessionCreateResponse.MaxResponseOutputTokens>
maxResponseOutputTokens()
Maximum number of output tokens for a single assistant response, inclusive of tool calls. final Optional<List<SessionCreateResponse.Modality>>
modalities()
The set of modalities the model can respond with. final Optional<String>
outputAudioFormat()
The format of output audio. final Optional<Double>
speed()
The speed of the model's spoken response. final Optional<Double>
temperature()
Sampling temperature for the model, limited to 0.6, 1. final Optional<String>
toolChoice()
How the model chooses tools. final Optional<List<SessionCreateResponse.Tool>>
tools()
Tools (functions) available to the model. final Optional<SessionCreateResponse.Tracing>
tracing()
Configuration options for tracing. final Optional<SessionCreateResponse.TurnDetection>
turnDetection()
Configuration for turn detection. final Optional<SessionCreateResponse.Voice>
voice()
The voice the model uses to respond. final JsonField<SessionCreateResponse.ClientSecret>
_clientSecret()
Returns the raw JSON value of clientSecret. final JsonField<String>
_inputAudioFormat()
Returns the raw JSON value of inputAudioFormat. final JsonField<SessionCreateResponse.InputAudioTranscription>
_inputAudioTranscription()
Returns the raw JSON value of inputAudioTranscription. final JsonField<String>
_instructions()
Returns the raw JSON value of instructions. final JsonField<SessionCreateResponse.MaxResponseOutputTokens>
_maxResponseOutputTokens()
Returns the raw JSON value of maxResponseOutputTokens. final JsonField<List<SessionCreateResponse.Modality>>
_modalities()
Returns the raw JSON value of modalities. final JsonField<String>
_outputAudioFormat()
Returns the raw JSON value of outputAudioFormat. final JsonField<Double>
_speed()
Returns the raw JSON value of speed. final JsonField<Double>
_temperature()
Returns the raw JSON value of temperature. final JsonField<String>
_toolChoice()
Returns the raw JSON value of toolChoice. final JsonField<List<SessionCreateResponse.Tool>>
_tools()
Returns the raw JSON value of tools. final JsonField<SessionCreateResponse.Tracing>
_tracing()
Returns the raw JSON value of tracing. final JsonField<SessionCreateResponse.TurnDetection>
_turnDetection()
Returns the raw JSON value of turnDetection. final JsonField<SessionCreateResponse.Voice>
_voice()
Returns the raw JSON value of voice. final Map<String, JsonValue>
_additionalProperties()
final SessionCreateResponse.Builder
toBuilder()
final SessionCreateResponse
validate()
final Boolean
isValid()
Boolean
equals(Object other)
Integer
hashCode()
String
toString()
final static SessionCreateResponse.Builder
builder()
Returns a mutable builder for constructing an instance of SessionCreateResponse. -
-
Method Detail
-
clientSecret
final SessionCreateResponse.ClientSecret clientSecret()
Ephemeral key returned by the API.
-
inputAudioFormat
final Optional<String> inputAudioFormat()
The format of input audio. Options are
pcm16
,g711_ulaw
, org711_alaw
.
-
inputAudioTranscription
final Optional<SessionCreateResponse.InputAudioTranscription> inputAudioTranscription()
Configuration for input audio transcription, defaults to off and can be set to
null
to turn off once on. Input audio transcription is not native to the model, since the model consumes audio directly. Transcription runs asynchronously and should be treated as rough guidance rather than the representation understood by the model.
-
instructions
final Optional<String> instructions()
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", "here are examples of good responses") and on audio behavior (e.g. "talk quickly", "inject emotion into your voice", "laugh frequently"). The instructions are not guaranteed to be followed by the model, but they provide guidance to the model on the desired behavior.
Note that the server sets default instructions which will be used if this field is not set and are visible in the
session.created
event at the start of the session.
-
maxResponseOutputTokens
final Optional<SessionCreateResponse.MaxResponseOutputTokens> maxResponseOutputTokens()
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 toinf
.
-
modalities
final Optional<List<SessionCreateResponse.Modality>> modalities()
The set of modalities the model can respond with. To disable audio, set this to "text".
-
outputAudioFormat
final Optional<String> outputAudioFormat()
The format of output audio. Options are
pcm16
,g711_ulaw
, org711_alaw
.
-
speed
final Optional<Double> speed()
The speed of the model's spoken response. 1.0 is the default speed. 0.25 is the minimum speed. 1.5 is the maximum speed. This value can only be changed in between model turns, not while a response is in progress.
-
temperature
final Optional<Double> temperature()
Sampling temperature for the model, limited to 0.6, 1.2. Defaults to 0.8.
-
toolChoice
final Optional<String> toolChoice()
How the model chooses tools. Options are
auto
,none
,required
, or specify a function.
-
tools
final Optional<List<SessionCreateResponse.Tool>> tools()
Tools (functions) available to the model.
-
tracing
final Optional<SessionCreateResponse.Tracing> tracing()
Configuration options for tracing. Set to null to disable tracing. Once tracing is enabled for a session, the configuration cannot be modified.
auto
will create a trace for the session with default values for the workflow name, group id, and metadata.
-
turnDetection
final Optional<SessionCreateResponse.TurnDetection> turnDetection()
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.
-
voice
final Optional<SessionCreateResponse.Voice> voice()
The voice the model uses to respond. Voice cannot be changed during the session once the model has responded with audio at least once. Current voice options are
alloy
,ash
,ballad
,coral
,echo
,sage
,shimmer
, andverse
.
-
_clientSecret
final JsonField<SessionCreateResponse.ClientSecret> _clientSecret()
Returns the raw JSON value of clientSecret.
Unlike clientSecret, this method doesn't throw if the JSON field has an unexpected type.
-
_inputAudioFormat
final JsonField<String> _inputAudioFormat()
Returns the raw JSON value of inputAudioFormat.
Unlike inputAudioFormat, this method doesn't throw if the JSON field has an unexpected type.
-
_inputAudioTranscription
final JsonField<SessionCreateResponse.InputAudioTranscription> _inputAudioTranscription()
Returns the raw JSON value of inputAudioTranscription.
Unlike inputAudioTranscription, this method doesn't throw if the JSON field has an unexpected type.
-
_instructions
final JsonField<String> _instructions()
Returns the raw JSON value of instructions.
Unlike instructions, this method doesn't throw if the JSON field has an unexpected type.
-
_maxResponseOutputTokens
final JsonField<SessionCreateResponse.MaxResponseOutputTokens> _maxResponseOutputTokens()
Returns the raw JSON value of maxResponseOutputTokens.
Unlike maxResponseOutputTokens, this method doesn't throw if the JSON field has an unexpected type.
-
_modalities
final JsonField<List<SessionCreateResponse.Modality>> _modalities()
Returns the raw JSON value of modalities.
Unlike modalities, this method doesn't throw if the JSON field has an unexpected type.
-
_outputAudioFormat
final JsonField<String> _outputAudioFormat()
Returns the raw JSON value of outputAudioFormat.
Unlike outputAudioFormat, this method doesn't throw if the JSON field has an unexpected type.
-
_speed
final JsonField<Double> _speed()
Returns the raw JSON value of speed.
Unlike speed, this method doesn't throw if the JSON field has an unexpected type.
-
_temperature
final JsonField<Double> _temperature()
Returns the raw JSON value of temperature.
Unlike temperature, this method doesn't throw if the JSON field has an unexpected type.
-
_toolChoice
final JsonField<String> _toolChoice()
Returns the raw JSON value of toolChoice.
Unlike toolChoice, this method doesn't throw if the JSON field has an unexpected type.
-
_tools
final JsonField<List<SessionCreateResponse.Tool>> _tools()
Returns the raw JSON value of tools.
Unlike tools, this method doesn't throw if the JSON field has an unexpected type.
-
_tracing
final JsonField<SessionCreateResponse.Tracing> _tracing()
Returns the raw JSON value of tracing.
Unlike tracing, this method doesn't throw if the JSON field has an unexpected type.
-
_turnDetection
final JsonField<SessionCreateResponse.TurnDetection> _turnDetection()
Returns the raw JSON value of turnDetection.
Unlike turnDetection, this method doesn't throw if the JSON field has an unexpected type.
-
_voice
final JsonField<SessionCreateResponse.Voice> _voice()
Returns the raw JSON value of voice.
Unlike voice, this method doesn't throw if the JSON field has an unexpected type.
-
_additionalProperties
final Map<String, JsonValue> _additionalProperties()
-
toBuilder
final SessionCreateResponse.Builder toBuilder()
-
validate
final SessionCreateResponse validate()
-
builder
final static SessionCreateResponse.Builder builder()
Returns a mutable builder for constructing an instance of SessionCreateResponse.
The following fields are required:
.clientSecret()
-
-
-
-