openai 0.87.0 → 0.88.0

data/lib/openai/resources/models.rb

@@ -9,7 +9,8 @@ module OpenAI
       #
       # @overload retrieve(model, request_options: {})
       #
-      # @param model [String] The ID of the model to use for this request
+      # @param model [String]
+      #   The ID of the model to use for this request
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -52,7 +53,8 @@ module OpenAI
       #
       # @overload delete(model, request_options: {})
       #
-      # @param model [String] The model to delete
+      # @param model [String]
+      #   The model to delete
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/openai/resources/moderations.rb

@@ -5,17 +5,21 @@ module OpenAI
     # Given text and/or image inputs, classifies if those inputs are potentially
     # harmful.
     class Moderations
-      # Some parameter documentations has been truncated, see
-      # {OpenAI::Models::ModerationCreateParams} for more details.
-      #
       # Classifies if text and/or image inputs are potentially harmful. Learn more in
-      # the [moderation guide](https://platform.openai.com/docs/guides/moderation).
+      # the
+      # [moderation guide](https://developers.openai.com/api/docs/guides/moderation).
       #
       # @overload create(input:, model: nil, request_options: {})
       #
-      # @param input [String, Array<String>, Array<OpenAI::Models::ModerationImageURLInput, OpenAI::Models::ModerationTextInput>] Input (or inputs) to classify. Can be a single string, an array of strings, or
+      # @param input [String, Array<String>, Array<OpenAI::Models::ModerationImageURLInput, OpenAI::Models::ModerationTextInput>]
+      #   Input (or inputs) to classify. Can be a single string, an array of strings, or
+      #   an array of multi-modal input objects similar to other models.
       #
-      # @param model [String, Symbol, OpenAI::Models::ModerationModel] The content moderation model you would like to use. Learn more in
+      # @param model [String, Symbol, OpenAI::Models::ModerationModel]
+      #   The content moderation model you would like to use. Learn more in
+      #   [the moderation guide](https://developers.openai.com/api/docs/guides/moderation),
+      #   and learn about available models
+      #   [here](https://developers.openai.com/api/docs/guides/moderation).
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/openai/resources/realtime/calls.rb

@@ -9,9 +9,11 @@ module OpenAI
         #
         # @overload create(sdp:, session: nil, request_options: {})
         #
-        # @param sdp [String] WebRTC Session Description Protocol (SDP) offer generated by the caller.
+        # @param sdp [String]
+        #   WebRTC Session Description Protocol (SDP) offer generated by the caller.
         #
-        # @param session [OpenAI::Models::Realtime::RealtimeSessionCreateRequest] Realtime session object configuration.
+        # @param session [OpenAI::Models::Realtime::RealtimeSessionCreateRequest]
+        #   Realtime session object configuration.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -58,43 +60,101 @@ module OpenAI
           )
         end
 
-        # Some parameter documentations has been truncated, see
-        # {OpenAI::Models::Realtime::CallAcceptParams} for more details.
-        #
         # Accept an incoming SIP call and configure the realtime session that will handle
         # it.
         #
         # @overload accept(call_id, audio: nil, include: nil, instructions: nil, max_output_tokens: nil, model: nil, output_modalities: nil, parallel_tool_calls: nil, prompt: nil, reasoning: nil, tool_choice: nil, tools: nil, tracing: nil, truncation: nil, type: :realtime, request_options: {})
         #
-        # @param call_id [String] The identifier for the call provided in the
-        #
-        # @param audio [OpenAI::Models::Realtime::RealtimeAudioConfig] Configuration for input and output audio.
-        #
-        # @param include [Array<Symbol, OpenAI::Models::Realtime::RealtimeSessionCreateRequest::Include>] Additional fields to include in server outputs.
-        #
-        # @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,
-        #
-        # @param model [String, Symbol, OpenAI::Models::Realtime::RealtimeSessionCreateRequest::Model] The Realtime model used for this session.
-        #
-        # @param output_modalities [Array<Symbol, OpenAI::Models::Realtime::RealtimeSessionCreateRequest::OutputModality>] The set of modalities the model can respond with. It defaults to `["audio"]`, in
-        #
-        # @param parallel_tool_calls [Boolean] Whether the model may call multiple tools in parallel. Only supported by
-        #
-        # @param prompt [OpenAI::Models::Responses::ResponsePrompt, nil] Reference to a prompt template and its variables.
-        #
-        # @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 tools [Array<OpenAI::Models::Realtime::RealtimeFunctionTool, OpenAI::Models::Realtime::RealtimeToolsConfigUnion::Mcp>] Tools available to the model.
-        #
-        # @param tracing [Symbol, :auto, OpenAI::Models::Realtime::RealtimeTracingConfig::TracingConfiguration, nil] Realtime API can write session traces to the [Traces Dashboard](https://platform
-        #
-        # @param truncation [Symbol, OpenAI::Models::Realtime::RealtimeTruncation::RealtimeTruncationStrategy, OpenAI::Models::Realtime::RealtimeTruncationRetentionRatio] When the number of tokens in a conversation exceeds the model's input token limi
-        #
-        # @param type [Symbol, :realtime] The type of session to create. Always `realtime` for the Realtime API.
+        # @param call_id [String]
+        #   The identifier for the call provided in the
+        #   [`realtime.call.incoming`](https://developers.openai.com/api/reference/resources/webhooks#realtime.call.incoming)
+        #   webhook.
+        #
+        # @param audio [OpenAI::Models::Realtime::RealtimeAudioConfig]
+        #   Configuration for input and output audio.
+        #
+        # @param include [Array<Symbol, OpenAI::Models::Realtime::RealtimeSessionCreateRequest::Include>]
+        #   Additional fields to include in server outputs.
+        #
+        #   `item.input_audio_transcription.logprobs`: Include logprobs for input audio
+        #   transcription.
+        #
+        # @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 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 model [String, Symbol, OpenAI::Models::Realtime::RealtimeSessionCreateRequest::Model]
+        #   The Realtime model used for this session.
+        #
+        # @param output_modalities [Array<Symbol, OpenAI::Models::Realtime::RealtimeSessionCreateRequest::OutputModality>]
+        #   The set of modalities the model can respond with. It defaults to `["audio"]`,
+        #   indicating that the model will respond with audio plus a transcript. `["text"]`
+        #   can be used to make the model respond with text only. It is not possible to
+        #   request both `text` and `audio` at the same time.
+        #
+        # @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.
+        #   [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 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::RealtimeToolsConfigUnion::Mcp>]
+        #   Tools available to the model.
+        #
+        # @param tracing [Symbol, :auto, OpenAI::Models::Realtime::RealtimeTracingConfig::TracingConfiguration, nil]
+        #   Realtime API can write session traces to the
+        #   [Traces Dashboard](https://platform.openai.com/logs?api=traces). 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.
+        #
+        # @param truncation [Symbol, OpenAI::Models::Realtime::RealtimeTruncation::RealtimeTruncationStrategy, OpenAI::Models::Realtime::RealtimeTruncationRetentionRatio]
+        #   When the number of tokens in a conversation exceeds the model's input token
+        #   limit, the conversation be truncated, meaning messages (starting from the
+        #   oldest) will not be included in the model's context. A 32k context model with
+        #   4,096 max output tokens can only include 28,224 tokens in the context before
+        #   truncation occurs.
+        #
+        #   Clients can configure truncation behavior to truncate with a lower max token
+        #   limit, which is an effective way to control token usage and cost.
+        #
+        #   Truncation will reduce the number of cached tokens on the next turn (busting the
+        #   cache), since messages are dropped from the beginning of the context. However,
+        #   clients can also configure truncation to retain messages up to a fraction of the
+        #   maximum context size, which will reduce the need for future truncations and thus
+        #   improve the cache rate.
+        #
+        #   Truncation can be disabled entirely, which means the server will never truncate
+        #   but would instead return an error if the conversation exceeds the model's input
+        #   token limit.
+        #
+        # @param type [Symbol, :realtime]
+        #   The type of session to create. Always `realtime` for the Realtime API.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -113,14 +173,16 @@ module OpenAI
           )
         end
 
-        # Some parameter documentations has been truncated, see
-        # {OpenAI::Models::Realtime::CallHangupParams} for more details.
-        #
         # End an active Realtime API call, whether it was initiated over SIP or WebRTC.
         #
         # @overload hangup(call_id, request_options: {})
         #
-        # @param call_id [String] The identifier for the call. For SIP calls, use the value provided in the
+        # @param call_id [String]
+        #   The identifier for the call. For SIP calls, use the value provided in the
+        #   [`realtime.call.incoming`](https://developers.openai.com/api/reference/resources/webhooks#realtime.call.incoming)
+        #   webhook. For WebRTC sessions, reuse the call ID returned in the `Location`
+        #   header when creating the call with
+        #   [`POST /v1/realtime/calls`](https://developers.openai.com/api/reference/resources/realtime/subresources/calls/methods/create).
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -137,16 +199,18 @@ module OpenAI
           )
         end
 
-        # Some parameter documentations has been truncated, see
-        # {OpenAI::Models::Realtime::CallReferParams} for more details.
-        #
         # Transfer an active SIP call to a new destination using the SIP REFER verb.
         #
         # @overload refer(call_id, target_uri:, request_options: {})
         #
-        # @param call_id [String] The identifier for the call provided in the
+        # @param call_id [String]
+        #   The identifier for the call provided in the
+        #   [`realtime.call.incoming`](https://developers.openai.com/api/reference/resources/webhooks#realtime.call.incoming)
+        #   webhook.
         #
-        # @param target_uri [String] URI that should appear in the SIP Refer-To header. Supports values like
+        # @param target_uri [String]
+        #   URI that should appear in the SIP Refer-To header. Supports values like
+        #   `tel:+14155550123` or `sip:agent@example.com`.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -165,16 +229,18 @@ module OpenAI
           )
         end
 
-        # Some parameter documentations has been truncated, see
-        # {OpenAI::Models::Realtime::CallRejectParams} for more details.
-        #
         # Decline an incoming SIP call by returning a SIP status code to the caller.
         #
         # @overload reject(call_id, status_code: nil, request_options: {})
         #
-        # @param call_id [String] The identifier for the call provided in the
+        # @param call_id [String]
+        #   The identifier for the call provided in the
+        #   [`realtime.call.incoming`](https://developers.openai.com/api/reference/resources/webhooks#realtime.call.incoming)
+        #   webhook.
         #
-        # @param status_code [Integer] SIP response code to send back to the caller. Defaults to `603` (Decline)
+        # @param status_code [Integer]
+        #   SIP response code to send back to the caller. Defaults to `603` (Decline) when
+        #   omitted.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #

data/lib/openai/resources/realtime/client_secrets.rb

@@ -4,9 +4,6 @@ module OpenAI
   module Resources
     class Realtime
       class ClientSecrets
-        # Some parameter documentations has been truncated, see
-        # {OpenAI::Models::Realtime::ClientSecretCreateParams} for more details.
-        #
         # Create a Realtime client secret with an associated session configuration.
         #
         # Client secrets are short-lived tokens that can be passed to a client app, such
@@ -18,16 +15,22 @@ module OpenAI
         # will be applied to any sessions created using that client secret, but these can
         # also be overridden by the client connection.
         #
-        # [Learn more about authentication with client secrets over WebRTC](https://platform.openai.com/docs/guides/realtime-webrtc).
+        # [Learn more about authentication with client secrets over WebRTC](https://developers.openai.com/api/docs/guides/realtime-webrtc).
         #
         # Returns the created client secret and the effective session object. The client
         # secret is a string that looks like `ek_1234`.
         #
         # @overload create(expires_after: nil, session: nil, request_options: {})
         #
-        # @param expires_after [OpenAI::Models::Realtime::ClientSecretCreateParams::ExpiresAfter] Configuration for the client secret expiration. Expiration refers to the time af
+        # @param expires_after [OpenAI::Models::Realtime::ClientSecretCreateParams::ExpiresAfter]
+        #   Configuration for the client secret expiration. Expiration refers to the time
+        #   after which a client secret will no longer be valid for creating sessions. The
+        #   session itself may continue after that time once started. A secret can be used
+        #   to create multiple sessions until it expires.
         #
-        # @param session [OpenAI::Models::Realtime::RealtimeSessionCreateRequest, OpenAI::Models::Realtime::RealtimeTranscriptionSessionCreateRequest] Session configuration to use for the client secret. Choose either a realtime
+        # @param session [OpenAI::Models::Realtime::RealtimeSessionCreateRequest, OpenAI::Models::Realtime::RealtimeTranscriptionSessionCreateRequest]
+        #   Session configuration to use for the client secret. Choose either a realtime
+        #   session or a transcription session.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #

data/lib/openai/resources/responses/input_items.rb

@@ -4,22 +4,29 @@ module OpenAI
   module Resources
     class Responses
       class InputItems
-        # Some parameter documentations has been truncated, see
-        # {OpenAI::Models::Responses::InputItemListParams} for more details.
-        #
         # Returns a list of input items for a given response.
         #
         # @overload list(response_id, after: nil, include: nil, limit: nil, order: nil, request_options: {})
         #
-        # @param response_id [String] The ID of the response to retrieve input items for.
+        # @param response_id [String]
+        #   The ID of the response to retrieve input items for.
+        #
+        # @param after [String]
+        #   An item ID to list items after, used in pagination.
         #
-        # @param after [String] An item ID to list items after, used in pagination.
+        # @param include [Array<Symbol, OpenAI::Models::Responses::ResponseIncludable>]
+        #   Additional fields to include in the response. See the `include` parameter for
+        #   Response creation above for more information.
         #
-        # @param include [Array<Symbol, OpenAI::Models::Responses::ResponseIncludable>] Additional fields to include in the response. See the `include`
+        # @param limit [Integer]
+        #   A limit on the number of objects to be returned. Limit can range between 1 and
+        #   100, and the default is 20.
         #
-        # @param limit [Integer] A limit on the number of objects to be returned. Limit can range between
+        # @param order [Symbol, OpenAI::Models::Responses::InputItemListParams::Order]
+        #   The order to return the input items in. Default is `desc`.
         #
-        # @param order [Symbol, OpenAI::Models::Responses::InputItemListParams::Order] The order to return the input items in. Default is `desc`.
+        #   - `asc`: Return the input items in ascending order.
+        #   - `desc`: Return the input items in descending order.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #

data/lib/openai/resources/responses/input_tokens.rb

@@ -4,9 +4,6 @@ module OpenAI
   module Resources
     class Responses
       class InputTokens
-        # Some parameter documentations has been truncated, see
-        # {OpenAI::Models::Responses::InputTokenCountParams} for more details.
-        #
         # Returns input token counts of the request.
         #
         # Returns an object with `object` set to `response.input_tokens` and an
@@ -14,29 +11,66 @@ module OpenAI
         #
         # @overload count(conversation: nil, input: nil, instructions: nil, model: nil, parallel_tool_calls: nil, personality: nil, previous_response_id: nil, reasoning: nil, text: nil, tool_choice: nil, tools: nil, truncation: nil, request_options: {})
         #
-        # @param conversation [String, OpenAI::Models::Responses::ResponseConversationParam, nil] The conversation that this response belongs to. Items from this conversation are
-        #
-        # @param input [String, Array<OpenAI::Models::Responses::EasyInputMessage, OpenAI::Models::Responses::ResponseInputItem::Message, OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput, OpenAI::Models::Responses::ResponseInputItem::ToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam, OpenAI::Models::Responses::ResponseInputItem::AdditionalTools, OpenAI::Models::Responses::ResponseConfigurationUpdateItemParam, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItemParam, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ShellCall, OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput, OpenAI::Models::Responses::ResponseInputItem::McpListTools, OpenAI::Models::Responses::ResponseInputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseInputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseInputItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseInputItem::CompactionTrigger, OpenAI::Models::Responses::ResponseInputItem::ItemReference, OpenAI::Models::Responses::ResponseInputItem::Program, OpenAI::Models::Responses::ResponseInputItem::ProgramOutput>, nil] Text, image, or file inputs to the model, used to generate a response
-        #
-        # @param instructions [String, nil] A system (or developer) message inserted into the model's context.
-        #
-        # @param model [String, nil] Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI offers a w
-        #
-        # @param parallel_tool_calls [Boolean, nil] Whether to allow the model to run tool calls in parallel.
-        #
-        # @param personality [String, Symbol, OpenAI::Models::Responses::InputTokenCountParams::Personality] A model-owned style preset to apply to this request. Omit this parameter to use
-        #
-        # @param previous_response_id [String, nil] The unique ID of the previous response to the model. Use this to create multi-tu
-        #
-        # @param reasoning [OpenAI::Models::Reasoning, nil] **gpt-5 and o-series models only** Configuration options for [reasoning models](
-        #
-        # @param text [OpenAI::Models::Responses::InputTokenCountParams::Text, nil] Configuration options for a text response from the model. Can be plain
-        #
-        # @param tool_choice [Symbol, OpenAI::Models::Responses::ToolChoiceOptions, OpenAI::Models::Responses::ToolChoiceAllowed, OpenAI::Models::Responses::ToolChoiceTypes, OpenAI::Models::Responses::ToolChoiceFunction, OpenAI::Models::Responses::ToolChoiceMcp, OpenAI::Models::Responses::ToolChoiceCustom, OpenAI::Models::Responses::InputTokenCountParams::ToolChoice::SpecificProgrammaticToolCallingParam, OpenAI::Models::Responses::ToolChoiceApplyPatch, OpenAI::Models::Responses::ToolChoiceShell, nil] Controls which tool the model should use, if any.
-        #
-        # @param tools [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::ComputerUsePreviewTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ProgrammaticToolCalling, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::FunctionShellTool, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::NamespaceTool, OpenAI::Models::Responses::ToolSearchTool, OpenAI::Models::Responses::ApplyPatchTool, OpenAI::Models::Responses::WebSearchTool, OpenAI::Models::Responses::WebSearchPreviewTool>, nil] An array of tools the model may call while generating a response. You can specif
-        #
-        # @param truncation [Symbol, OpenAI::Models::Responses::InputTokenCountParams::Truncation] The truncation strategy to use for the model response. - `auto`: If the input to
+        # @param conversation [String, OpenAI::Models::Responses::ResponseConversationParam, nil]
+        #   The conversation that this response belongs to. Items from this conversation are
+        #   prepended to `input_items` for this response request. Input items and output
+        #   items from this response are automatically added to this conversation after this
+        #   response completes.
+        #
+        # @param input [String, Array<OpenAI::Models::Responses::EasyInputMessage, OpenAI::Models::Responses::ResponseInputItem::Message, OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput, OpenAI::Models::Responses::ResponseInputItem::ToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam, OpenAI::Models::Responses::ResponseInputItem::AdditionalTools, OpenAI::Models::Responses::ResponseConfigurationUpdateItemParam, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItemParam, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ShellCall, OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput, OpenAI::Models::Responses::ResponseInputItem::McpListTools, OpenAI::Models::Responses::ResponseInputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseInputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseInputItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseInputItem::CompactionTrigger, OpenAI::Models::Responses::ResponseInputItem::ItemReference, OpenAI::Models::Responses::ResponseInputItem::Program, OpenAI::Models::Responses::ResponseInputItem::ProgramOutput>, nil]
+        #   Text, image, or file inputs to the model, used to generate a response
+        #
+        # @param instructions [String, nil]
+        #   A system (or developer) message inserted into the model's context. When used
+        #   along with `previous_response_id`, the instructions from a previous response
+        #   will not be carried over to the next response. This makes it simple to swap out
+        #   system (or developer) messages in new responses.
+        #
+        # @param model [String, nil]
+        #   Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI offers a
+        #   wide range of models with different capabilities, performance characteristics,
+        #   and price points. Refer to the
+        #   [model guide](https://developers.openai.com/api/docs/models) to browse and
+        #   compare available models.
+        #
+        # @param parallel_tool_calls [Boolean, nil]
+        #   Whether to allow the model to run tool calls in parallel.
+        #
+        # @param personality [String, Symbol, OpenAI::Models::Responses::InputTokenCountParams::Personality]
+        #   A model-owned style preset to apply to this request. Omit this parameter to use
+        #   the model's default style. Supported values may expand over time. Values must be
+        #   at most 64 characters.
+        #
+        # @param previous_response_id [String, nil]
+        #   The unique ID of the previous response to the model. Use this to create
+        #   multi-turn conversations. Learn more about
+        #   [conversation state](https://developers.openai.com/api/docs/guides/conversation-state).
+        #   Cannot be used in conjunction with `conversation`.
+        #
+        # @param reasoning [OpenAI::Models::Reasoning, nil]
+        #   **gpt-5 and o-series models only** Configuration options for
+        #   [reasoning models](https://developers.openai.com/api/docs/guides/reasoning).
+        #
+        # @param text [OpenAI::Models::Responses::InputTokenCountParams::Text, nil]
+        #   Configuration options for a text response from the model. Can be plain text or
+        #   structured JSON data. Learn more:
+        #
+        #   - [Text inputs and outputs](https://developers.openai.com/api/docs/guides/text)
+        #   - [Structured Outputs](https://developers.openai.com/api/docs/guides/structured-outputs)
+        #
+        # @param tool_choice [Symbol, OpenAI::Models::Responses::ToolChoiceOptions, OpenAI::Models::Responses::ToolChoiceAllowed, OpenAI::Models::Responses::ToolChoiceTypes, OpenAI::Models::Responses::ToolChoiceFunction, OpenAI::Models::Responses::ToolChoiceMcp, OpenAI::Models::Responses::ToolChoiceCustom, OpenAI::Models::Responses::InputTokenCountParams::ToolChoice::SpecificProgrammaticToolCallingParam, OpenAI::Models::Responses::ToolChoiceApplyPatch, OpenAI::Models::Responses::ToolChoiceShell, nil]
+        #   Controls which tool the model should use, if any.
+        #
+        # @param tools [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::ComputerUsePreviewTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ProgrammaticToolCalling, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::FunctionShellTool, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::NamespaceTool, OpenAI::Models::Responses::ToolSearchTool, OpenAI::Models::Responses::ApplyPatchTool, OpenAI::Models::Responses::WebSearchTool, OpenAI::Models::Responses::WebSearchPreviewTool>, nil]
+        #   An array of tools the model may call while generating a response. You can
+        #   specify which tool to use by setting the `tool_choice` parameter.
+        #
+        # @param truncation [Symbol, OpenAI::Models::Responses::InputTokenCountParams::Truncation]
+        #   The truncation strategy to use for the model response. - `auto`: If the input to
+        #   this Response exceeds the model's context window size, the model will truncate
+        #   the response to fit the context window by dropping items from the beginning of
+        #   the conversation. - `disabled` (default): If the input size will exceed the
+        #   context window size for a model, the request will fail with a 400 error.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #