class

OpenAI::RealtimeResponseCreateParams

Inherits JSON::Serializable < Reference < Object

Create a new Realtime response with these parameters

Constructors

new(output_modalities : Array(RealtimeResponseCreateParamsOutputModalitiesItem) | Nil = nil, instructions : String | Nil = nil, audio : RealtimeResponseCreateParamsAudio | Nil = nil, tools : Array(RealtimeResponseCreateParamsToolsItem) | Nil = nil, tool_choice : RealtimeResponseCreateParamsToolChoice | Nil = nil, max_output_tokens : RealtimeResponseCreateParamsMaxOutputTokens | Nil = nil, conversation : RealtimeResponseCreateParamsConversation | Nil = nil, metadata : Metadata | Nil = nil, prompt : Prompt | Nil = nil, input : Array(RealtimeConversationItem) | Nil = nil)
Source
new(*, __pull_for_json_serializable pull : JSON::PullParser)
Source

Instance methods

audio

Configuration for audio input and output.

Source
audio=(audio : RealtimeResponseCreateParamsAudio | Nil)

Configuration for audio input and output.

Source
conversation

Controls which conversation the response is added to. Currently supports auto and none, with auto as the default value. The auto value means that the contents of the response will be added to the default conversation. Set this to none to create an out-of-band response which will not add items to default conversation.

Source
conversation=(conversation : RealtimeResponseCreateParamsConversation | Nil)

Controls which conversation the response is added to. Currently supports auto and none, with auto as the default value. The auto value means that the contents of the response will be added to the default conversation. Set this to none to create an out-of-band response which will not add items to default conversation.

Source
input

Input items to include in the prompt for the model. Using this field creates a new context for this Response instead of using the default conversation. An empty array [] will clear the context for this Response. Note that this can include references to items that previously appeared in the session using their id.

Source
input=(input : Array(RealtimeConversationItem) | Nil)

Input items to include in the prompt for the model. Using this field creates a new context for this Response instead of using the default conversation. An empty array [] will clear the context for this Response. Note that this can include references to items that previously appeared in the session using their id.

Source
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.

Source
instructions=(instructions : String | Nil)

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.

Source
max_output_tokens

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.

Source
max_output_tokens=(max_output_tokens : RealtimeResponseCreateParamsMaxOutputTokens | Nil)

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.

Source
metadata
Source
metadata=(metadata : Metadata | Nil)
Source
output_modalities

The set of modalities the model used to respond, currently the only possible values are [\"audio\"], [\"text\"]. Audio output always include a text transcript. Setting the output to mode text will disable audio output from the model.

Source
output_modalities=(output_modalities : Array(RealtimeResponseCreateParamsOutputModalitiesItem) | Nil)

The set of modalities the model used to respond, currently the only possible values are [\"audio\"], [\"text\"]. Audio output always include a text transcript. Setting the output to mode text will disable audio output from the model.

Source
prompt
Source
prompt=(prompt : Prompt | Nil)
Source
tool_choice

How the model chooses tools. Provide one of the string modes or force a specific function/MCP tool.

Source
tool_choice=(tool_choice : RealtimeResponseCreateParamsToolChoice | Nil)

How the model chooses tools. Provide one of the string modes or force a specific function/MCP tool.

Source
tools

Tools available to the model.

Source
tools=(tools : Array(RealtimeResponseCreateParamsToolsItem) | Nil)

Tools available to the model.

Source