openai 0.87.0 → 0.89.0

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

@@ -50,7 +50,7 @@ module OpenAI
         #   Identifier for service connectors, like those available in ChatGPT. One of
         #   `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
         #   service connectors
-        #   [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
+        #   [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
         #
         #   Currently supported `connector_id` values are:
         #
@@ -110,37 +110,64 @@ module OpenAI
         optional :tunnel_id, String
 
         # @!method initialize(server_label:, allowed_callers: nil, allowed_tools: nil, authorization: nil, connector_id: nil, defer_loading: nil, headers: nil, require_approval: nil, server_description: nil, server_url: nil, tunnel_id: nil, type: :mcp)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool} for more details.
-        #
         #   Give the model access to additional tools via remote Model Context Protocol
         #   (MCP) servers.
-        #   [Learn more about MCP](https://platform.openai.com/docs/guides/tools-remote-mcp).
+        #   [Learn more about MCP](https://developers.openai.com/api/docs/guides/tools-connectors-mcp).
         #
-        #   @param server_label [String] A label for this MCP server, used to identify it in tool calls.
+        #   @param server_label [String]
+        #     A label for this MCP server, used to identify it in tool calls.
         #
-        #   @param allowed_callers [Array<Symbol, OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::AllowedCaller>, nil] The tool invocation context(s).
+        #   @param allowed_callers [Array<Symbol, OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::AllowedCaller>, nil]
+        #     The tool invocation context(s).
         #
-        #   @param allowed_tools [Array<String>, OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::AllowedTools::McpToolFilter, nil] List of allowed tool names or a filter object.
+        #   @param allowed_tools [Array<String>, OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::AllowedTools::McpToolFilter, nil]
+        #     List of allowed tool names or a filter object.
         #
-        #   @param authorization [String] An OAuth access token that can be used with a remote MCP server, either
+        #   @param authorization [String]
+        #     An OAuth access token that can be used with a remote MCP server, either with a
+        #     custom MCP server URL or a service connector. Your application must handle the
+        #     OAuth authorization flow and provide the token here.
         #
-        #   @param connector_id [Symbol, OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::ConnectorID] Identifier for service connectors, like those available in ChatGPT. One of
+        #   @param connector_id [Symbol, OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::ConnectorID]
+        #     Identifier for service connectors, like those available in ChatGPT. One of
+        #     `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+        #     service connectors
+        #     [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
         #
-        #   @param defer_loading [Boolean] Whether this MCP tool is deferred and discovered via tool search.
+        #     Currently supported `connector_id` values are:
         #
-        #   @param headers [Hash{Symbol=>String}, nil] Optional HTTP headers to send to the MCP server. Use for authentication
+        #     - Dropbox: `connector_dropbox`
+        #     - Gmail: `connector_gmail`
+        #     - Google Calendar: `connector_googlecalendar`
+        #     - Google Drive: `connector_googledrive`
+        #     - Microsoft Teams: `connector_microsoftteams`
+        #     - Outlook Calendar: `connector_outlookcalendar`
+        #     - Outlook Email: `connector_outlookemail`
+        #     - SharePoint: `connector_sharepoint`
         #
-        #   @param require_approval [OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::RequireApproval::McpToolApprovalFilter, Symbol, OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::RequireApproval::McpToolApprovalSetting, nil] Specify which of the MCP server's tools require approval.
+        #   @param defer_loading [Boolean]
+        #     Whether this MCP tool is deferred and discovered via tool search.
         #
-        #   @param server_description [String] Optional description of the MCP server, used to provide more context.
+        #   @param headers [Hash{Symbol=>String}, nil]
+        #     Optional HTTP headers to send to the MCP server. Use for authentication or other
+        #     purposes.
         #
-        #   @param server_url [String] The URL for the MCP server. One of `server_url`, `connector_id`, or
+        #   @param require_approval [OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::RequireApproval::McpToolApprovalFilter, Symbol, OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::RequireApproval::McpToolApprovalSetting, nil]
+        #     Specify which of the MCP server's tools require approval.
         #
-        #   @param tunnel_id [String] The Secure MCP Tunnel ID to use instead of a direct server URL. One of
+        #   @param server_description [String]
+        #     Optional description of the MCP server, used to provide more context.
         #
-        #   @param type [Symbol, :mcp] The type of the MCP tool. Always `mcp`.
-
+        #   @param server_url [String]
+        #     The URL for the MCP server. One of `server_url`, `connector_id`, or `tunnel_id`
+        #     must be provided.
+        #
+        #   @param tunnel_id [String]
+        #     The Secure MCP Tunnel ID to use instead of a direct server URL. One of
+        #     `server_url`, `connector_id`, or `tunnel_id` must be provided.
+        #
+        #   @param type [Symbol, :mcp]
+        #     The type of the MCP tool. Always `mcp`.
         module AllowedCaller
           extend OpenAI::Internal::Type::Enum
 
@@ -180,15 +207,16 @@ module OpenAI
             optional :tool_names, OpenAI::Internal::Type::ArrayOf[String]
 
             # @!method initialize(read_only: nil, tool_names: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::AllowedTools::McpToolFilter}
-            #   for more details.
-            #
             #   A filter object to specify which tools are allowed.
             #
-            #   @param read_only [Boolean] Indicates whether or not a tool modifies data or is read-only. If an
+            #   @param read_only [Boolean]
+            #     Indicates whether or not a tool modifies data or is read-only. If an MCP server
+            #     is
+            #     [annotated with `readOnlyHint`](https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations-readonlyhint),
+            #     it will match this filter.
             #
-            #   @param tool_names [Array<String>] List of allowed tool names.
+            #   @param tool_names [Array<String>]
+            #     List of allowed tool names.
           end
 
           # @!method self.variants
@@ -201,7 +229,7 @@ module OpenAI
         # Identifier for service connectors, like those available in ChatGPT. One of
         # `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
         # service connectors
-        # [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
+        # [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
         #
         # Currently supported `connector_id` values are:
         #
@@ -267,16 +295,14 @@ module OpenAI
             )
 
             # @!method initialize(always: nil, never: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::RequireApproval::McpToolApprovalFilter}
-            #   for more details.
-            #
             #   Specify which of the MCP server's tools require approval. Can be `always`,
             #   `never`, or a filter object associated with tools that require approval.
             #
-            #   @param always [OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::RequireApproval::McpToolApprovalFilter::Always] A filter object to specify which tools are allowed.
+            #   @param always [OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::RequireApproval::McpToolApprovalFilter::Always]
+            #     A filter object to specify which tools are allowed.
             #
-            #   @param never [OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::RequireApproval::McpToolApprovalFilter::Never] A filter object to specify which tools are allowed.
+            #   @param never [OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::RequireApproval::McpToolApprovalFilter::Never]
+            #     A filter object to specify which tools are allowed.
 
             # @see OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::RequireApproval::McpToolApprovalFilter#always
             class Always < OpenAI::Internal::Type::BaseModel
@@ -296,15 +322,16 @@ module OpenAI
               optional :tool_names, OpenAI::Internal::Type::ArrayOf[String]
 
               # @!method initialize(read_only: nil, tool_names: nil)
-              #   Some parameter documentations has been truncated, see
-              #   {OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::RequireApproval::McpToolApprovalFilter::Always}
-              #   for more details.
-              #
               #   A filter object to specify which tools are allowed.
               #
-              #   @param read_only [Boolean] Indicates whether or not a tool modifies data or is read-only. If an
+              #   @param read_only [Boolean]
+              #     Indicates whether or not a tool modifies data or is read-only. If an MCP server
+              #     is
+              #     [annotated with `readOnlyHint`](https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations-readonlyhint),
+              #     it will match this filter.
               #
-              #   @param tool_names [Array<String>] List of allowed tool names.
+              #   @param tool_names [Array<String>]
+              #     List of allowed tool names.
             end
 
             # @see OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::RequireApproval::McpToolApprovalFilter#never
@@ -325,15 +352,16 @@ module OpenAI
               optional :tool_names, OpenAI::Internal::Type::ArrayOf[String]
 
               # @!method initialize(read_only: nil, tool_names: nil)
-              #   Some parameter documentations has been truncated, see
-              #   {OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::RequireApproval::McpToolApprovalFilter::Never}
-              #   for more details.
-              #
               #   A filter object to specify which tools are allowed.
               #
-              #   @param read_only [Boolean] Indicates whether or not a tool modifies data or is read-only. If an
+              #   @param read_only [Boolean]
+              #     Indicates whether or not a tool modifies data or is read-only. If an MCP server
+              #     is
+              #     [annotated with `readOnlyHint`](https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations-readonlyhint),
+              #     it will match this filter.
               #
-              #   @param tool_names [Array<String>] List of allowed tool names.
+              #   @param tool_names [Array<String>]
+              #     List of allowed tool names.
             end
           end
 

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

@@ -84,7 +84,7 @@ module OpenAI
 
         # @!attribute prompt
         #   Reference to a prompt template and its variables.
-        #   [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
+        #   [Learn more](https://developers.openai.com/api/docs/guides/text?api-mode=responses#version-prompts-in-code).
         #
         #   @return [OpenAI::Models::Responses::ResponsePrompt, nil]
         optional :prompt, -> { OpenAI::Responses::ResponsePrompt }, nil?: true
@@ -112,34 +112,72 @@ module OpenAI
         )
 
         # @!method initialize(audio: nil, conversation: nil, input: nil, instructions: nil, max_output_tokens: nil, metadata: nil, output_modalities: nil, parallel_tool_calls: nil, prompt: nil, reasoning: nil, tool_choice: nil, tools: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Realtime::RealtimeResponseCreateParams} for more details.
-        #
         #   Create a new Realtime response with these parameters
         #
-        #   @param audio [OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput] Configuration for audio input and output.
+        #   @param audio [OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput]
+        #     Configuration for audio input and output.
+        #
+        #   @param conversation [String, Symbol, OpenAI::Models::Realtime::RealtimeResponseCreateParams::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.
         #
-        #   @param conversation [String, Symbol, OpenAI::Models::Realtime::RealtimeResponseCreateParams::Conversation] Controls which conversation the response is added to. Currently supports
+        #   @param input [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>]
+        #     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.
         #
-        #   @param input [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>] Input items to include in the prompt for the model. Using this field
+        #   @param 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", "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.
         #
-        #   @param instructions [String] The default system instructions (i.e. system message) prepended to model calls.
+        #   @param max_output_tokens [Integer, Symbol, :inf]
+        #     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`.
         #
-        #   @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 output_modalities [Array<Symbol, OpenAI::Models::Realtime::RealtimeResponseCreateParams::OutputModality>] The set of modalities the model used to respond, currently the only possible val
+        #   @param output_modalities [Array<Symbol, OpenAI::Models::Realtime::RealtimeResponseCreateParams::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 parallel_tool_calls [Boolean] Whether the model may call multiple tools in parallel. Only supported by
+        #   @param parallel_tool_calls [Boolean]
+        #     Whether the model may call multiple tools in parallel. Only supported by
+        #     reasoning Realtime models such as `gpt-realtime-2`.
         #
-        #   @param prompt [OpenAI::Models::Responses::ResponsePrompt, nil] Reference to a prompt template and its variables.
+        #   @param prompt [OpenAI::Models::Responses::ResponsePrompt, nil]
+        #     Reference to a prompt template and its variables.
+        #     [Learn more](https://developers.openai.com/api/docs/guides/text?api-mode=responses#version-prompts-in-code).
         #
-        #   @param reasoning [OpenAI::Models::Realtime::RealtimeReasoning] Configuration for reasoning-capable Realtime models such as `gpt-realtime-2`.
+        #   @param reasoning [OpenAI::Models::Realtime::RealtimeReasoning]
+        #     Configuration for reasoning-capable Realtime models such as `gpt-realtime-2`.
         #
-        #   @param tool_choice [Symbol, OpenAI::Models::Responses::ToolChoiceOptions, OpenAI::Models::Responses::ToolChoiceFunction, OpenAI::Models::Responses::ToolChoiceMcp] How the model chooses tools. Provide one of the string modes or force a specific
+        #   @param tool_choice [Symbol, OpenAI::Models::Responses::ToolChoiceOptions, OpenAI::Models::Responses::ToolChoiceFunction, OpenAI::Models::Responses::ToolChoiceMcp]
+        #     How the model chooses tools. Provide one of the string modes or force a specific
+        #     function/MCP tool.
         #
-        #   @param tools [Array<OpenAI::Models::Realtime::RealtimeFunctionTool, OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool>] Tools available to the model.
+        #   @param tools [Array<OpenAI::Models::Realtime::RealtimeFunctionTool, OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool>]
+        #     Tools available to the model.
 
         # 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
@@ -227,14 +265,14 @@ module OpenAI
 
         # Give the model access to additional tools via remote Model Context Protocol
         # (MCP) servers.
-        # [Learn more about MCP](https://platform.openai.com/docs/guides/tools-remote-mcp).
+        # [Learn more about MCP](https://developers.openai.com/api/docs/guides/tools-connectors-mcp).
         module Tool
           extend OpenAI::Internal::Type::Union
 
           variant -> { OpenAI::Realtime::RealtimeFunctionTool }
 
           # Give the model access to additional tools via remote Model Context Protocol
-          # (MCP) servers. [Learn more about MCP](https://platform.openai.com/docs/guides/tools-remote-mcp).
+          # (MCP) servers. [Learn more about MCP](https://developers.openai.com/api/docs/guides/tools-connectors-mcp).
           variant -> { OpenAI::Realtime::RealtimeResponseCreateMcpTool }
 
           # @!method self.variants

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

@@ -29,16 +29,22 @@ module OpenAI
         optional :type, enum: -> { OpenAI::Realtime::RealtimeResponseStatus::Type }
 
         # @!method initialize(error: nil, reason: nil, type: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Realtime::RealtimeResponseStatus} for more details.
-        #
         #   Additional details about the status.
         #
-        #   @param error [OpenAI::Models::Realtime::RealtimeResponseStatus::Error] A description of the error that caused the response to fail,
+        #   @param error [OpenAI::Models::Realtime::RealtimeResponseStatus::Error]
+        #     A description of the error that caused the response to fail, populated when the
+        #     `status` is `failed`.
         #
-        #   @param reason [Symbol, OpenAI::Models::Realtime::RealtimeResponseStatus::Reason] The reason the Response did not complete. For a `cancelled` Response, one of `t
+        #   @param reason [Symbol, OpenAI::Models::Realtime::RealtimeResponseStatus::Reason]
+        #     The reason the Response did not complete. For a `cancelled` Response, one of
+        #     `turn_detected` (the server VAD detected a new start of speech) or
+        #     `client_cancelled` (the client sent a cancel event). For an `incomplete`
+        #     Response, one of `max_output_tokens` or `content_filter` (the server-side safety
+        #     filter activated and cut off the response).
         #
-        #   @param type [Symbol, OpenAI::Models::Realtime::RealtimeResponseStatus::Type] The type of error that caused the response to fail, corresponding
+        #   @param type [Symbol, OpenAI::Models::Realtime::RealtimeResponseStatus::Type]
+        #     The type of error that caused the response to fail, corresponding with the
+        #     `status` field (`completed`, `cancelled`, `incomplete`, `failed`).
 
         # @see OpenAI::Models::Realtime::RealtimeResponseStatus#error
         class Error < OpenAI::Internal::Type::BaseModel
@@ -58,9 +64,11 @@ module OpenAI
           #   A description of the error that caused the response to fail, populated when the
           #   `status` is `failed`.
           #
-          #   @param code [String] Error code, if any.
+          #   @param code [String]
+          #     Error code, if any.
           #
-          #   @param type [String] The type of error.
+          #   @param type [String]
+          #     The type of error.
         end
 
         # The reason the Response did not complete. For a `cancelled` Response, one of

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

@@ -41,23 +41,31 @@ module OpenAI
         optional :total_tokens, Integer
 
         # @!method initialize(input_token_details: nil, input_tokens: nil, output_token_details: nil, output_tokens: nil, total_tokens: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Realtime::RealtimeResponseUsage} for more details.
-        #
         #   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.
         #
-        #   @param input_token_details [OpenAI::Models::Realtime::RealtimeResponseUsageInputTokenDetails] Details about the input tokens used in the Response. Cached tokens are tokens fr
+        #   @param input_token_details [OpenAI::Models::Realtime::RealtimeResponseUsageInputTokenDetails]
+        #     Details about the input tokens used in the Response. Cached tokens are tokens
+        #     from previous turns in the conversation that are included as context for the
+        #     current response. Cached tokens here are counted as a subset of input tokens,
+        #     meaning input tokens will include cached and uncached tokens.
         #
-        #   @param input_tokens [Integer] The number of input tokens used in the Response, including text and
+        #   @param input_tokens [Integer]
+        #     The number of input tokens used in the Response, including text and audio
+        #     tokens.
         #
-        #   @param output_token_details [OpenAI::Models::Realtime::RealtimeResponseUsageOutputTokenDetails] Details about the output tokens used in the Response.
+        #   @param output_token_details [OpenAI::Models::Realtime::RealtimeResponseUsageOutputTokenDetails]
+        #     Details about the output tokens used in the Response.
         #
-        #   @param output_tokens [Integer] The number of output tokens sent in the Response, including text and
+        #   @param output_tokens [Integer]
+        #     The number of output tokens sent in the Response, including text and audio
+        #     tokens.
         #
-        #   @param total_tokens [Integer] The total number of tokens in the Response including input and output
+        #   @param total_tokens [Integer]
+        #     The total number of tokens in the Response including input and output text and
+        #     audio tokens.
       end
     end
   end

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

@@ -43,15 +43,20 @@ module OpenAI
         #   current response. Cached tokens here are counted as a subset of input tokens,
         #   meaning input tokens will include cached and uncached tokens.
         #
-        #   @param audio_tokens [Integer] The number of audio tokens used as input for the Response.
+        #   @param audio_tokens [Integer]
+        #     The number of audio tokens used as input for the Response.
         #
-        #   @param cached_tokens [Integer] The number of cached tokens used as input for the Response.
+        #   @param cached_tokens [Integer]
+        #     The number of cached tokens used as input for the Response.
         #
-        #   @param cached_tokens_details [OpenAI::Models::Realtime::RealtimeResponseUsageInputTokenDetails::CachedTokensDetails] Details about the cached tokens used as input for the Response.
+        #   @param cached_tokens_details [OpenAI::Models::Realtime::RealtimeResponseUsageInputTokenDetails::CachedTokensDetails]
+        #     Details about the cached tokens used as input for the Response.
         #
-        #   @param image_tokens [Integer] The number of image tokens used as input for the Response.
+        #   @param image_tokens [Integer]
+        #     The number of image tokens used as input for the Response.
         #
-        #   @param text_tokens [Integer] The number of text tokens used as input for the Response.
+        #   @param text_tokens [Integer]
+        #     The number of text tokens used as input for the Response.
 
         # @see OpenAI::Models::Realtime::RealtimeResponseUsageInputTokenDetails#cached_tokens_details
         class CachedTokensDetails < OpenAI::Internal::Type::BaseModel
@@ -76,11 +81,14 @@ module OpenAI
           # @!method initialize(audio_tokens: nil, image_tokens: nil, text_tokens: nil)
           #   Details about the cached tokens used as input for the Response.
           #
-          #   @param audio_tokens [Integer] The number of cached audio tokens used as input for the Response.
+          #   @param audio_tokens [Integer]
+          #     The number of cached audio tokens used as input for the Response.
           #
-          #   @param image_tokens [Integer] The number of cached image tokens used as input for the Response.
+          #   @param image_tokens [Integer]
+          #     The number of cached image tokens used as input for the Response.
           #
-          #   @param text_tokens [Integer] The number of cached text tokens used as input for the Response.
+          #   @param text_tokens [Integer]
+          #     The number of cached text tokens used as input for the Response.
         end
       end
     end

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

@@ -19,9 +19,11 @@ module OpenAI
         # @!method initialize(audio_tokens: nil, text_tokens: nil)
         #   Details about the output tokens used in the Response.
         #
-        #   @param audio_tokens [Integer] The number of audio tokens used in the Response.
+        #   @param audio_tokens [Integer]
+        #     The number of audio tokens used in the Response.
         #
-        #   @param text_tokens [Integer] The number of text tokens used in the Response.
+        #   @param text_tokens [Integer]
+        #     The number of text tokens used in the Response.
       end
     end
   end

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

@@ -201,7 +201,7 @@ module OpenAI
         # **WebRTC/SIP Only:** Emitted when the server begins streaming audio to the client. This event is
         # emitted after an audio content part has been added (`response.content_part.added`)
         # to the response.
-        # [Learn more](https://platform.openai.com/docs/guides/realtime-conversations#client-and-server-events-for-audio-in-webrtc).
+        # [Learn more](https://developers.openai.com/api/docs/guides/realtime-conversations#client-and-server-events-for-audio-in-webrtc).
         variant(
           :"output_audio_buffer.started",
           -> { OpenAI::Realtime::RealtimeServerEvent::OutputAudioBufferStarted }
@@ -210,7 +210,7 @@ module OpenAI
         # **WebRTC/SIP Only:** Emitted when the output audio buffer has been completely drained on the server,
         # and no more audio is forthcoming. This event is emitted after the full response
         # data has been sent to the client (`response.done`).
-        # [Learn more](https://platform.openai.com/docs/guides/realtime-conversations#client-and-server-events-for-audio-in-webrtc).
+        # [Learn more](https://developers.openai.com/api/docs/guides/realtime-conversations#client-and-server-events-for-audio-in-webrtc).
         variant(
           :"output_audio_buffer.stopped",
           -> { OpenAI::Realtime::RealtimeServerEvent::OutputAudioBufferStopped }
@@ -220,7 +220,7 @@ module OpenAI
         # mode when the user has interrupted (`input_audio_buffer.speech_started`),
         # or when the client has emitted the `output_audio_buffer.clear` event to manually
         # cut off the current audio response.
-        # [Learn more](https://platform.openai.com/docs/guides/realtime-conversations#client-and-server-events-for-audio-in-webrtc).
+        # [Learn more](https://developers.openai.com/api/docs/guides/realtime-conversations#client-and-server-events-for-audio-in-webrtc).
         variant(
           :"output_audio_buffer.cleared",
           -> { OpenAI::Realtime::RealtimeServerEvent::OutputAudioBufferCleared }
@@ -310,11 +310,14 @@ module OpenAI
           #   data after noise cancellation and VAD. It includes the full content of the Item,
           #   including audio data.
           #
-          #   @param event_id [String] The unique ID of the server event.
+          #   @param event_id [String]
+          #     The unique ID of the server event.
           #
-          #   @param item [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] A single item within a Realtime conversation.
+          #   @param item [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]
+          #     A single item within a Realtime conversation.
           #
-          #   @param type [Symbol, :"conversation.item.retrieved"] The event type, must be `conversation.item.retrieved`.
+          #   @param type [Symbol, :"conversation.item.retrieved"]
+          #     The event type, must be `conversation.item.retrieved`.
         end
 
         class OutputAudioBufferStarted < OpenAI::Internal::Type::BaseModel
@@ -340,13 +343,16 @@ module OpenAI
           #   **WebRTC/SIP Only:** Emitted when the server begins streaming audio to the
           #   client. This event is emitted after an audio content part has been added
           #   (`response.content_part.added`) to the response.
-          #   [Learn more](https://platform.openai.com/docs/guides/realtime-conversations#client-and-server-events-for-audio-in-webrtc).
+          #   [Learn more](https://developers.openai.com/api/docs/guides/realtime-conversations#client-and-server-events-for-audio-in-webrtc).
           #
-          #   @param event_id [String] The unique ID of the server event.
+          #   @param event_id [String]
+          #     The unique ID of the server event.
           #
-          #   @param response_id [String] The unique ID of the response that produced the audio.
+          #   @param response_id [String]
+          #     The unique ID of the response that produced the audio.
           #
-          #   @param type [Symbol, :"output_audio_buffer.started"] The event type, must be `output_audio_buffer.started`.
+          #   @param type [Symbol, :"output_audio_buffer.started"]
+          #     The event type, must be `output_audio_buffer.started`.
         end
 
         class OutputAudioBufferStopped < OpenAI::Internal::Type::BaseModel
@@ -372,13 +378,16 @@ module OpenAI
           #   **WebRTC/SIP Only:** Emitted when the output audio buffer has been completely
           #   drained on the server, and no more audio is forthcoming. This event is emitted
           #   after the full response data has been sent to the client (`response.done`).
-          #   [Learn more](https://platform.openai.com/docs/guides/realtime-conversations#client-and-server-events-for-audio-in-webrtc).
+          #   [Learn more](https://developers.openai.com/api/docs/guides/realtime-conversations#client-and-server-events-for-audio-in-webrtc).
           #
-          #   @param event_id [String] The unique ID of the server event.
+          #   @param event_id [String]
+          #     The unique ID of the server event.
           #
-          #   @param response_id [String] The unique ID of the response that produced the audio.
+          #   @param response_id [String]
+          #     The unique ID of the response that produced the audio.
           #
-          #   @param type [Symbol, :"output_audio_buffer.stopped"] The event type, must be `output_audio_buffer.stopped`.
+          #   @param type [Symbol, :"output_audio_buffer.stopped"]
+          #     The event type, must be `output_audio_buffer.stopped`.
         end
 
         class OutputAudioBufferCleared < OpenAI::Internal::Type::BaseModel
@@ -406,13 +415,16 @@ module OpenAI
           #   (`input_audio_buffer.speech_started`), or when the client has emitted the
           #   `output_audio_buffer.clear` event to manually cut off the current audio
           #   response.
-          #   [Learn more](https://platform.openai.com/docs/guides/realtime-conversations#client-and-server-events-for-audio-in-webrtc).
+          #   [Learn more](https://developers.openai.com/api/docs/guides/realtime-conversations#client-and-server-events-for-audio-in-webrtc).
           #
-          #   @param event_id [String] The unique ID of the server event.
+          #   @param event_id [String]
+          #     The unique ID of the server event.
           #
-          #   @param response_id [String] The unique ID of the response that produced the audio.
+          #   @param response_id [String]
+          #     The unique ID of the response that produced the audio.
           #
-          #   @param type [Symbol, :"output_audio_buffer.cleared"] The event type, must be `output_audio_buffer.cleared`.
+          #   @param type [Symbol, :"output_audio_buffer.cleared"]
+          #     The event type, must be `output_audio_buffer.cleared`.
         end
 
         # @!method self.variants