openai 0.87.0 → 0.89.0

data/lib/openai/models/realtime/realtime_conversation_item_function_call_output.rb

@@ -44,23 +44,28 @@ module OpenAI
         optional :status, enum: -> { OpenAI::Realtime::RealtimeConversationItemFunctionCallOutput::Status }
 
         # @!method initialize(call_id:, output:, id: nil, object: nil, status: nil, type: :function_call_output)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Realtime::RealtimeConversationItemFunctionCallOutput} for more
-        #   details.
-        #
         #   A function call output item in a Realtime conversation.
         #
-        #   @param call_id [String] The ID of the function call this output is for.
+        #   @param call_id [String]
+        #     The ID of the function call this output is for.
         #
-        #   @param output [String] The output of the function call, this is free text and can contain any informati
+        #   @param output [String]
+        #     The output of the function call, this is free text and can contain any
+        #     information or simply be empty.
         #
-        #   @param id [String] The unique ID of the item. This may be provided by the client or generated by th
+        #   @param id [String]
+        #     The unique ID of the item. This may be provided by the client or generated by
+        #     the server.
         #
-        #   @param object [Symbol, OpenAI::Models::Realtime::RealtimeConversationItemFunctionCallOutput::Object] Identifier for the API object being returned - always `realtime.item`. Optional
+        #   @param object [Symbol, OpenAI::Models::Realtime::RealtimeConversationItemFunctionCallOutput::Object]
+        #     Identifier for the API object being returned - always `realtime.item`. Optional
+        #     when creating a new item.
         #
-        #   @param status [Symbol, OpenAI::Models::Realtime::RealtimeConversationItemFunctionCallOutput::Status] The status of the item. Has no effect on the conversation.
+        #   @param status [Symbol, OpenAI::Models::Realtime::RealtimeConversationItemFunctionCallOutput::Status]
+        #     The status of the item. Has no effect on the conversation.
         #
-        #   @param type [Symbol, :function_call_output] The type of the item. Always `function_call_output`.
+        #   @param type [Symbol, :function_call_output]
+        #     The type of the item. Always `function_call_output`.
 
         # Identifier for the API object being returned - always `realtime.item`. Optional
         # when creating a new item.

data/lib/openai/models/realtime/realtime_conversation_item_system_message.rb

@@ -46,10 +46,6 @@ module OpenAI
         optional :status, enum: -> { OpenAI::Realtime::RealtimeConversationItemSystemMessage::Status }
 
         # @!method initialize(content:, id: nil, object: nil, status: nil, role: :system, type: :message)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Realtime::RealtimeConversationItemSystemMessage} for more
-        #   details.
-        #
         #   A system message in a Realtime conversation can be used to provide additional
         #   context or instructions to the model. This is similar but distinct from the
         #   instruction prompt provided at the start of a conversation, as system messages
@@ -57,18 +53,25 @@ module OpenAI
         #   conversation's behavior, use instructions, but for smaller updates (e.g. "the
         #   user is now asking about a different topic"), use system messages.
         #
-        #   @param content [Array<OpenAI::Models::Realtime::RealtimeConversationItemSystemMessage::Content>] The content of the message.
+        #   @param content [Array<OpenAI::Models::Realtime::RealtimeConversationItemSystemMessage::Content>]
+        #     The content of the message.
         #
-        #   @param id [String] The unique ID of the item. This may be provided by the client or generated by th
+        #   @param id [String]
+        #     The unique ID of the item. This may be provided by the client or generated by
+        #     the server.
         #
-        #   @param object [Symbol, OpenAI::Models::Realtime::RealtimeConversationItemSystemMessage::Object] Identifier for the API object being returned - always `realtime.item`. Optional
+        #   @param object [Symbol, OpenAI::Models::Realtime::RealtimeConversationItemSystemMessage::Object]
+        #     Identifier for the API object being returned - always `realtime.item`. Optional
+        #     when creating a new item.
         #
-        #   @param status [Symbol, OpenAI::Models::Realtime::RealtimeConversationItemSystemMessage::Status] The status of the item. Has no effect on the conversation.
+        #   @param status [Symbol, OpenAI::Models::Realtime::RealtimeConversationItemSystemMessage::Status]
+        #     The status of the item. Has no effect on the conversation.
         #
-        #   @param role [Symbol, :system] The role of the message sender. Always `system`.
+        #   @param role [Symbol, :system]
+        #     The role of the message sender. Always `system`.
         #
-        #   @param type [Symbol, :message] The type of the item. Always `message`.
-
+        #   @param type [Symbol, :message]
+        #     The type of the item. Always `message`.
         class Content < OpenAI::Internal::Type::BaseModel
           # @!attribute text
           #   The text content.
@@ -83,9 +86,11 @@ module OpenAI
           optional :type, enum: -> { OpenAI::Realtime::RealtimeConversationItemSystemMessage::Content::Type }
 
           # @!method initialize(text: nil, type: nil)
-          #   @param text [String] The text content.
+          #   @param text [String]
+          #     The text content.
           #
-          #   @param type [Symbol, OpenAI::Models::Realtime::RealtimeConversationItemSystemMessage::Content::Type] The content type. Always `input_text` for system messages.
+          #   @param type [Symbol, OpenAI::Models::Realtime::RealtimeConversationItemSystemMessage::Content::Type]
+          #     The content type. Always `input_text` for system messages.
 
           # The content type. Always `input_text` for system messages.
           #

data/lib/openai/models/realtime/realtime_conversation_item_user_message.rb

@@ -46,24 +46,27 @@ module OpenAI
         optional :status, enum: -> { OpenAI::Realtime::RealtimeConversationItemUserMessage::Status }
 
         # @!method initialize(content:, id: nil, object: nil, status: nil, role: :user, type: :message)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Realtime::RealtimeConversationItemUserMessage} for more
-        #   details.
-        #
         #   A user message item in a Realtime conversation.
         #
-        #   @param content [Array<OpenAI::Models::Realtime::RealtimeConversationItemUserMessage::Content>] The content of the message.
+        #   @param content [Array<OpenAI::Models::Realtime::RealtimeConversationItemUserMessage::Content>]
+        #     The content of the message.
         #
-        #   @param id [String] The unique ID of the item. This may be provided by the client or generated by th
+        #   @param id [String]
+        #     The unique ID of the item. This may be provided by the client or generated by
+        #     the server.
         #
-        #   @param object [Symbol, OpenAI::Models::Realtime::RealtimeConversationItemUserMessage::Object] Identifier for the API object being returned - always `realtime.item`. Optional
+        #   @param object [Symbol, OpenAI::Models::Realtime::RealtimeConversationItemUserMessage::Object]
+        #     Identifier for the API object being returned - always `realtime.item`. Optional
+        #     when creating a new item.
         #
-        #   @param status [Symbol, OpenAI::Models::Realtime::RealtimeConversationItemUserMessage::Status] The status of the item. Has no effect on the conversation.
+        #   @param status [Symbol, OpenAI::Models::Realtime::RealtimeConversationItemUserMessage::Status]
+        #     The status of the item. Has no effect on the conversation.
         #
-        #   @param role [Symbol, :user] The role of the message sender. Always `user`.
+        #   @param role [Symbol, :user]
+        #     The role of the message sender. Always `user`.
         #
-        #   @param type [Symbol, :message] The type of the item. Always `message`.
-
+        #   @param type [Symbol, :message]
+        #     The type of the item. Always `message`.
         class Content < OpenAI::Internal::Type::BaseModel
           # @!attribute audio
           #   Base64-encoded audio bytes (for `input_audio`), these will be parsed as the
@@ -108,21 +111,29 @@ module OpenAI
           optional :type, enum: -> { OpenAI::Realtime::RealtimeConversationItemUserMessage::Content::Type }
 
           # @!method initialize(audio: nil, detail: nil, image_url: nil, text: nil, transcript: nil, type: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Realtime::RealtimeConversationItemUserMessage::Content} for
-          #   more details.
-          #
-          #   @param audio [String] Base64-encoded audio bytes (for `input_audio`), these will be parsed as the form
+          #   @param audio [String]
+          #     Base64-encoded audio bytes (for `input_audio`), these will be parsed as the
+          #     format specified in the session input audio type configuration. This defaults to
+          #     PCM 16-bit 24kHz mono if not specified.
           #
-          #   @param detail [Symbol, OpenAI::Models::Realtime::RealtimeConversationItemUserMessage::Content::Detail] The detail level of the image (for `input_image`). `auto` will default to `high`
+          #   @param detail [Symbol, OpenAI::Models::Realtime::RealtimeConversationItemUserMessage::Content::Detail]
+          #     The detail level of the image (for `input_image`). `auto` will default to
+          #     `high`.
           #
-          #   @param image_url [String] Base64-encoded image bytes (for `input_image`) as a data URI. For example `data:
+          #   @param image_url [String]
+          #     Base64-encoded image bytes (for `input_image`) as a data URI. For example
+          #     `data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...`. Supported formats are PNG
+          #     and JPEG.
           #
-          #   @param text [String] The text content (for `input_text`).
+          #   @param text [String]
+          #     The text content (for `input_text`).
           #
-          #   @param transcript [String] Transcript of the audio (for `input_audio`). This is not sent to the model, but
+          #   @param transcript [String]
+          #     Transcript of the audio (for `input_audio`). This is not sent to the model, but
+          #     will be attached to the message item for reference.
           #
-          #   @param type [Symbol, OpenAI::Models::Realtime::RealtimeConversationItemUserMessage::Content::Type] The content type (`input_text`, `input_audio`, or `input_image`).
+          #   @param type [Symbol, OpenAI::Models::Realtime::RealtimeConversationItemUserMessage::Content::Type]
+          #     The content type (`input_text`, `input_audio`, or `input_image`).
 
           # The detail level of the image (for `input_image`). `auto` will default to
           # `high`.

data/lib/openai/models/realtime/realtime_error.rb

@@ -35,20 +35,22 @@ module OpenAI
         optional :param, String, nil?: true
 
         # @!method initialize(message:, type:, code: nil, event_id: nil, param: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Realtime::RealtimeError} for more details.
-        #
         #   Details of the error.
         #
-        #   @param message [String] A human-readable error message.
+        #   @param message [String]
+        #     A human-readable error message.
         #
-        #   @param type [String] The type of error (e.g., "invalid_request_error", "server_error").
+        #   @param type [String]
+        #     The type of error (e.g., "invalid_request_error", "server_error").
         #
-        #   @param code [String, nil] Error code, if any.
+        #   @param code [String, nil]
+        #     Error code, if any.
         #
-        #   @param event_id [String, nil] The event_id of the client event that caused the error, if applicable.
+        #   @param event_id [String, nil]
+        #     The event_id of the client event that caused the error, if applicable.
         #
-        #   @param param [String, nil] Parameter related to the error, if any.
+        #   @param param [String, nil]
+        #     Parameter related to the error, if any.
       end
     end
   end

data/lib/openai/models/realtime/realtime_error_event.rb

@@ -27,11 +27,14 @@ module OpenAI
         #   problem. Most errors are recoverable and the session will stay open, we
         #   recommend to implementors to monitor and log error messages by default.
         #
-        #   @param error [OpenAI::Models::Realtime::RealtimeError] Details of the error.
+        #   @param error [OpenAI::Models::Realtime::RealtimeError]
+        #     Details of the error.
         #
-        #   @param event_id [String] The unique ID of the server event.
+        #   @param event_id [String]
+        #     The unique ID of the server event.
         #
-        #   @param type [Symbol, :error] The event type, must be `error`.
+        #   @param type [Symbol, :error]
+        #     The event type, must be `error`.
       end
     end
   end

data/lib/openai/models/realtime/realtime_function_tool.rb

@@ -30,16 +30,18 @@ module OpenAI
         optional :type, enum: -> { OpenAI::Realtime::RealtimeFunctionTool::Type }
 
         # @!method initialize(description: nil, name: nil, parameters: nil, type: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Realtime::RealtimeFunctionTool} for more details.
+        #   @param 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).
         #
-        #   @param description [String] The description of the function, including guidance on when and how
+        #   @param name [String]
+        #     The name of the function.
         #
-        #   @param name [String] The name of the function.
+        #   @param parameters [Object]
+        #     Parameters of the function in JSON Schema.
         #
-        #   @param parameters [Object] Parameters of the function in JSON Schema.
-        #
-        #   @param type [Symbol, OpenAI::Models::Realtime::RealtimeFunctionTool::Type] The type of the tool, i.e. `function`.
+        #   @param type [Symbol, OpenAI::Models::Realtime::RealtimeFunctionTool::Type]
+        #     The type of the tool, i.e. `function`.
 
         # The type of the tool, i.e. `function`.
         #

data/lib/openai/models/realtime/realtime_mcp_approval_request.rb

@@ -37,15 +37,20 @@ module OpenAI
         # @!method initialize(id:, arguments:, name:, server_label:, type: :mcp_approval_request)
         #   A Realtime item requesting human approval of a tool invocation.
         #
-        #   @param id [String] The unique ID of the approval request.
+        #   @param id [String]
+        #     The unique ID of the approval request.
         #
-        #   @param arguments [String] A JSON string of arguments for the tool.
+        #   @param arguments [String]
+        #     A JSON string of arguments for the tool.
         #
-        #   @param name [String] The name of the tool to run.
+        #   @param name [String]
+        #     The name of the tool to run.
         #
-        #   @param server_label [String] The label of the MCP server making the request.
+        #   @param server_label [String]
+        #     The label of the MCP server making the request.
         #
-        #   @param type [Symbol, :mcp_approval_request] The type of the item. Always `mcp_approval_request`.
+        #   @param type [Symbol, :mcp_approval_request]
+        #     The type of the item. Always `mcp_approval_request`.
       end
     end
   end

data/lib/openai/models/realtime/realtime_mcp_approval_response.rb

@@ -37,15 +37,20 @@ module OpenAI
         # @!method initialize(id:, approval_request_id:, approve:, reason: nil, type: :mcp_approval_response)
         #   A Realtime item responding to an MCP approval request.
         #
-        #   @param id [String] The unique ID of the approval response.
+        #   @param id [String]
+        #     The unique ID of the approval response.
         #
-        #   @param approval_request_id [String] The ID of the approval request being answered.
+        #   @param approval_request_id [String]
+        #     The ID of the approval request being answered.
         #
-        #   @param approve [Boolean] Whether the request was approved.
+        #   @param approve [Boolean]
+        #     Whether the request was approved.
         #
-        #   @param reason [String, nil] Optional reason for the decision.
+        #   @param reason [String, nil]
+        #     Optional reason for the decision.
         #
-        #   @param type [Symbol, :mcp_approval_response] The type of the item. Always `mcp_approval_response`.
+        #   @param type [Symbol, :mcp_approval_response]
+        #     The type of the item. Always `mcp_approval_response`.
       end
     end
   end

data/lib/openai/models/realtime/realtime_mcp_list_tools.rb

@@ -31,14 +31,17 @@ module OpenAI
         # @!method initialize(server_label:, tools:, id: nil, type: :mcp_list_tools)
         #   A Realtime item listing tools available on an MCP server.
         #
-        #   @param server_label [String] The label of the MCP server.
+        #   @param server_label [String]
+        #     The label of the MCP server.
         #
-        #   @param tools [Array<OpenAI::Models::Realtime::RealtimeMcpListTools::Tool>] The tools available on the server.
+        #   @param tools [Array<OpenAI::Models::Realtime::RealtimeMcpListTools::Tool>]
+        #     The tools available on the server.
         #
-        #   @param id [String] The unique ID of the list.
+        #   @param id [String]
+        #     The unique ID of the list.
         #
-        #   @param type [Symbol, :mcp_list_tools] The type of the item. Always `mcp_list_tools`.
-
+        #   @param type [Symbol, :mcp_list_tools]
+        #     The type of the item. Always `mcp_list_tools`.
         class Tool < OpenAI::Internal::Type::BaseModel
           # @!attribute input_schema
           #   The JSON schema describing the tool's input.
@@ -65,18 +68,19 @@ module OpenAI
           optional :description, String, nil?: true
 
           # @!method initialize(input_schema:, name:, annotations: nil, description: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Realtime::RealtimeMcpListTools::Tool} for more details.
-          #
           #   A tool available on an MCP server.
           #
-          #   @param input_schema [Object] The JSON schema describing the tool's input.
+          #   @param input_schema [Object]
+          #     The JSON schema describing the tool's input.
           #
-          #   @param name [String] The name of the tool.
+          #   @param name [String]
+          #     The name of the tool.
           #
-          #   @param annotations [Object, nil] Additional annotations about the tool.
+          #   @param annotations [Object, nil]
+          #     Additional annotations about the tool.
           #
-          #   @param description [String, nil] The description of the tool.
+          #   @param description [String, nil]
+          #     The description of the tool.
         end
       end
     end

data/lib/openai/models/realtime/realtime_mcp_tool_call.rb

@@ -55,21 +55,29 @@ module OpenAI
         # @!method initialize(id:, arguments:, name:, server_label:, approval_request_id: nil, error: nil, output: nil, type: :mcp_call)
         #   A Realtime item representing an invocation of a tool on an MCP server.
         #
-        #   @param id [String] The unique ID of the tool call.
+        #   @param id [String]
+        #     The unique ID of the tool call.
         #
-        #   @param arguments [String] A JSON string of the arguments passed to the tool.
+        #   @param arguments [String]
+        #     A JSON string of the arguments passed to the tool.
         #
-        #   @param name [String] The name of the tool that was run.
+        #   @param name [String]
+        #     The name of the tool that was run.
         #
-        #   @param server_label [String] The label of the MCP server running the tool.
+        #   @param server_label [String]
+        #     The label of the MCP server running the tool.
         #
-        #   @param approval_request_id [String, nil] The ID of an associated approval request, if any.
+        #   @param approval_request_id [String, nil]
+        #     The ID of an associated approval request, if any.
         #
-        #   @param error [OpenAI::Models::Realtime::RealtimeMcpProtocolError, OpenAI::Models::Realtime::RealtimeMcpToolExecutionError, OpenAI::Models::Realtime::RealtimeMcphttpError, nil] The error from the tool call, if any.
+        #   @param error [OpenAI::Models::Realtime::RealtimeMcpProtocolError, OpenAI::Models::Realtime::RealtimeMcpToolExecutionError, OpenAI::Models::Realtime::RealtimeMcphttpError, nil]
+        #     The error from the tool call, if any.
         #
-        #   @param output [String, nil] The output from the tool call.
+        #   @param output [String, nil]
+        #     The output from the tool call.
         #
-        #   @param type [Symbol, :mcp_call] The type of the item. Always `mcp_call`.
+        #   @param type [Symbol, :mcp_call]
+        #     The type of the item. Always `mcp_call`.
 
         # The error from the tool call, if any.
         #

data/lib/openai/models/realtime/realtime_reasoning.rb

@@ -12,12 +12,11 @@ module OpenAI
         optional :effort, enum: -> { OpenAI::Realtime::RealtimeReasoningEffort }
 
         # @!method initialize(effort: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Realtime::RealtimeReasoning} for more details.
-        #
         #   Configuration for reasoning-capable Realtime models such as `gpt-realtime-2`.
         #
-        #   @param effort [Symbol, OpenAI::Models::Realtime::RealtimeReasoningEffort] Constrains effort on reasoning for reasoning-capable Realtime models such as
+        #   @param effort [Symbol, OpenAI::Models::Realtime::RealtimeReasoningEffort]
+        #     Constrains effort on reasoning for reasoning-capable Realtime models such as
+        #     `gpt-realtime-2`.
       end
     end
   end

data/lib/openai/models/realtime/realtime_response.rb

@@ -92,32 +92,58 @@ module OpenAI
         optional :usage, -> { OpenAI::Realtime::RealtimeResponseUsage }
 
         # @!method initialize(id: nil, audio: nil, conversation_id: nil, max_output_tokens: nil, metadata: nil, object: nil, output: nil, output_modalities: nil, status: nil, status_details: nil, usage: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Realtime::RealtimeResponse} for more details.
-        #
         #   The response resource.
         #
-        #   @param id [String] The unique ID of the response, will look like `resp_1234`.
+        #   @param id [String]
+        #     The unique ID of the response, will look like `resp_1234`.
+        #
+        #   @param audio [OpenAI::Models::Realtime::RealtimeResponse::Audio]
+        #     Configuration for audio output.
         #
-        #   @param audio [OpenAI::Models::Realtime::RealtimeResponse::Audio] Configuration for audio output.
+        #   @param conversation_id [String]
+        #     Which conversation the response is added to, determined by the `conversation`
+        #     field in the `response.create` event. If `auto`, the response will be added to
+        #     the default conversation and the value of `conversation_id` will be an id like
+        #     `conv_1234`. If `none`, the response will not be added to any conversation and
+        #     the value of `conversation_id` will be `null`. If responses are being triggered
+        #     automatically by VAD the response will be added to the default conversation
         #
-        #   @param conversation_id [String] Which conversation the response is added to, determined by the `conversation`
+        #   @param max_output_tokens [Integer, Symbol, :inf]
+        #     Maximum number of output tokens for a single assistant response, inclusive of
+        #     tool calls, that was used in this response.
         #
-        #   @param max_output_tokens [Integer, Symbol, :inf] Maximum number of output tokens for a single assistant response,
+        #   @param metadata [Hash{Symbol=>String}, nil]
+        #     Set of 16 key-value pairs that can be attached to an object. This can be useful
+        #     for storing additional information about the object in a structured format, and
+        #     querying for objects via API or the dashboard.
         #
-        #   @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
+        #     Keys are strings with a maximum length of 64 characters. Values are strings with
+        #     a maximum length of 512 characters.
         #
-        #   @param object [Symbol, OpenAI::Models::Realtime::RealtimeResponse::Object] The object type, must be `realtime.response`.
+        #   @param object [Symbol, OpenAI::Models::Realtime::RealtimeResponse::Object]
+        #     The object type, must be `realtime.response`.
         #
-        #   @param output [Array<OpenAI::Models::Realtime::RealtimeConversationItemSystemMessage, OpenAI::Models::Realtime::RealtimeConversationItemUserMessage, OpenAI::Models::Realtime::RealtimeConversationItemAssistantMessage, OpenAI::Models::Realtime::RealtimeConversationItemFunctionCall, OpenAI::Models::Realtime::RealtimeConversationItemFunctionCallOutput, OpenAI::Models::Realtime::RealtimeMcpApprovalResponse, OpenAI::Models::Realtime::RealtimeMcpListTools, OpenAI::Models::Realtime::RealtimeMcpToolCall, OpenAI::Models::Realtime::RealtimeMcpApprovalRequest>] The list of output items generated by the response.
+        #   @param output [Array<OpenAI::Models::Realtime::RealtimeConversationItemSystemMessage, OpenAI::Models::Realtime::RealtimeConversationItemUserMessage, OpenAI::Models::Realtime::RealtimeConversationItemAssistantMessage, OpenAI::Models::Realtime::RealtimeConversationItemFunctionCall, OpenAI::Models::Realtime::RealtimeConversationItemFunctionCallOutput, OpenAI::Models::Realtime::RealtimeMcpApprovalResponse, OpenAI::Models::Realtime::RealtimeMcpListTools, OpenAI::Models::Realtime::RealtimeMcpToolCall, OpenAI::Models::Realtime::RealtimeMcpApprovalRequest>]
+        #     The list of output items generated by the response.
         #
-        #   @param output_modalities [Array<Symbol, OpenAI::Models::Realtime::RealtimeResponse::OutputModality>] The set of modalities the model used to respond, currently the only possible val
+        #   @param output_modalities [Array<Symbol, OpenAI::Models::Realtime::RealtimeResponse::OutputModality>]
+        #     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.
         #
-        #   @param status [Symbol, OpenAI::Models::Realtime::RealtimeResponse::Status] The final status of the response (`completed`, `cancelled`, `failed`, or
+        #   @param status [Symbol, OpenAI::Models::Realtime::RealtimeResponse::Status]
+        #     The final status of the response (`completed`, `cancelled`, `failed`, or
+        #     `incomplete`, `in_progress`).
         #
-        #   @param status_details [OpenAI::Models::Realtime::RealtimeResponseStatus] Additional details about the status.
+        #   @param status_details [OpenAI::Models::Realtime::RealtimeResponseStatus]
+        #     Additional details about the status.
         #
-        #   @param usage [OpenAI::Models::Realtime::RealtimeResponseUsage] Usage statistics for the Response, this will correspond to billing. A
+        #   @param usage [OpenAI::Models::Realtime::RealtimeResponseUsage]
+        #     Usage statistics for the Response, this will correspond to billing. A Realtime
+        #     API session will maintain a conversation context and append new Items to the
+        #     Conversation, thus output from previous turns (text and audio tokens) will
+        #     become the input for later turns.
 
         # @see OpenAI::Models::Realtime::RealtimeResponse#audio
         class Audio < OpenAI::Internal::Type::BaseModel
@@ -149,12 +175,14 @@ module OpenAI
             optional :voice, union: -> { OpenAI::Realtime::RealtimeResponse::Audio::Output::Voice }
 
             # @!method initialize(format_: nil, voice: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Realtime::RealtimeResponse::Audio::Output} for more details.
-            #
-            #   @param format_ [OpenAI::Models::Realtime::RealtimeAudioFormats::AudioPCM, OpenAI::Models::Realtime::RealtimeAudioFormats::AudioPCMU, OpenAI::Models::Realtime::RealtimeAudioFormats::AudioPCMA] The format of the output audio.
+            #   @param format_ [OpenAI::Models::Realtime::RealtimeAudioFormats::AudioPCM, OpenAI::Models::Realtime::RealtimeAudioFormats::AudioPCMU, OpenAI::Models::Realtime::RealtimeAudioFormats::AudioPCMA]
+            #     The format of the output audio.
             #
-            #   @param voice [String, Symbol, OpenAI::Models::Realtime::RealtimeResponse::Audio::Output::Voice] The voice the model uses to respond. Voice cannot be changed during the
+            #   @param voice [String, Symbol, OpenAI::Models::Realtime::RealtimeResponse::Audio::Output::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`, `verse`, `marin`,
+            #     and `cedar`. We recommend `marin` and `cedar` for best quality.
 
             # 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

data/lib/openai/models/realtime/realtime_response_create_audio_output.rb

@@ -34,13 +34,16 @@ module OpenAI
           optional :voice, union: -> { OpenAI::Realtime::RealtimeResponseCreateAudioOutput::Output::Voice }
 
           # @!method initialize(format_: nil, voice: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output} for more
-          #   details.
+          #   @param format_ [OpenAI::Models::Realtime::RealtimeAudioFormats::AudioPCM, OpenAI::Models::Realtime::RealtimeAudioFormats::AudioPCMU, OpenAI::Models::Realtime::RealtimeAudioFormats::AudioPCMA]
+          #     The format of the output audio.
           #
-          #   @param format_ [OpenAI::Models::Realtime::RealtimeAudioFormats::AudioPCM, OpenAI::Models::Realtime::RealtimeAudioFormats::AudioPCMU, OpenAI::Models::Realtime::RealtimeAudioFormats::AudioPCMA] The format of the output audio.
-          #
-          #   @param voice [String, Symbol, OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output::Voice::ID, OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output::Voice] The voice the model uses to respond. Supported built-in voices are
+          #   @param voice [String, Symbol, OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output::Voice::ID, OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output::Voice]
+          #     The voice the model uses to respond. Supported built-in voices are `alloy`,
+          #     `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
+          #     `cedar`. You may also provide a custom voice object with an `id`, for example
+          #     `{ "id": "voice_1234" }`. Voice cannot be changed during the session once the
+          #     model has responded with audio at least once. We recommend `marin` and `cedar`
+          #     for best quality.
 
           # The voice the model uses to respond. Supported built-in voices are `alloy`,
           # `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
@@ -88,7 +91,8 @@ module OpenAI
               # @!method initialize(id:)
               #   Custom voice reference.
               #
-              #   @param id [String] The custom voice ID, e.g. `voice_1234`.
+              #   @param id [String]
+              #     The custom voice ID, e.g. `voice_1234`.
             end
 
             # @!method self.variants