openai 0.3.0 → 0.4.0.pre.beta.1

data/lib/openai/models/responses/response_content_part_added_event.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Responses
+      class ResponseContentPartAddedEvent < OpenAI::Internal::Type::BaseModel
+        # @!attribute content_index
+        #   The index of the content part that was added.
+        #
+        #   @return [Integer]
+        required :content_index, Integer
+
+        # @!attribute item_id
+        #   The ID of the output item that the content part was added to.
+        #
+        #   @return [String]
+        required :item_id, String
+
+        # @!attribute output_index
+        #   The index of the output item that the content part was added to.
+        #
+        #   @return [Integer]
+        required :output_index, Integer
+
+        # @!attribute part
+        #   The content part that was added.
+        #
+        #   @return [OpenAI::Models::Responses::ResponseOutputText, OpenAI::Models::Responses::ResponseOutputRefusal]
+        required :part, union: -> { OpenAI::Responses::ResponseContentPartAddedEvent::Part }
+
+        # @!attribute sequence_number
+        #   The sequence number of this event.
+        #
+        #   @return [Integer]
+        required :sequence_number, Integer
+
+        # @!attribute type
+        #   The type of the event. Always `response.content_part.added`.
+        #
+        #   @return [Symbol, :"response.content_part.added"]
+        required :type, const: :"response.content_part.added"
+
+        # @!method initialize(content_index:, item_id:, output_index:, part:, sequence_number:, type: :"response.content_part.added")
+        #   Some parameter documentations has been truncated, see
+        #   {OpenAI::Models::Responses::ResponseContentPartAddedEvent} for more details.
+        #
+        #   Emitted when a new content part is added.
+        #
+        #   @param content_index [Integer] The index of the content part that was added.
+        #
+        #   @param item_id [String] The ID of the output item that the content part was added to.
+        #
+        #   @param output_index [Integer] The index of the output item that the content part was added to.
+        #
+        #   @param part [OpenAI::Models::Responses::ResponseOutputText, OpenAI::Models::Responses::ResponseOutputRefusal] The content part that was added.
+        #
+        #   @param sequence_number [Integer] The sequence number of this event.
+        #
+        #   @param type [Symbol, :"response.content_part.added"] The type of the event. Always `response.content_part.added`.
+
+        # The content part that was added.
+        #
+        # @see OpenAI::Models::Responses::ResponseContentPartAddedEvent#part
+        module Part
+          extend OpenAI::Internal::Type::Union
+
+          discriminator :type
+
+          # A text output from the model.
+          variant :output_text, -> { OpenAI::Responses::ResponseOutputText }
+
+          # A refusal from the model.
+          variant :refusal, -> { OpenAI::Responses::ResponseOutputRefusal }
+
+          # @!method self.variants
+          #   @return [Array(OpenAI::Models::Responses::ResponseOutputText, OpenAI::Models::Responses::ResponseOutputRefusal)]
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/responses/response_content_part_done_event.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Responses
+      class ResponseContentPartDoneEvent < OpenAI::Internal::Type::BaseModel
+        # @!attribute content_index
+        #   The index of the content part that is done.
+        #
+        #   @return [Integer]
+        required :content_index, Integer
+
+        # @!attribute item_id
+        #   The ID of the output item that the content part was added to.
+        #
+        #   @return [String]
+        required :item_id, String
+
+        # @!attribute output_index
+        #   The index of the output item that the content part was added to.
+        #
+        #   @return [Integer]
+        required :output_index, Integer
+
+        # @!attribute part
+        #   The content part that is done.
+        #
+        #   @return [OpenAI::Models::Responses::ResponseOutputText, OpenAI::Models::Responses::ResponseOutputRefusal]
+        required :part, union: -> { OpenAI::Responses::ResponseContentPartDoneEvent::Part }
+
+        # @!attribute sequence_number
+        #   The sequence number of this event.
+        #
+        #   @return [Integer]
+        required :sequence_number, Integer
+
+        # @!attribute type
+        #   The type of the event. Always `response.content_part.done`.
+        #
+        #   @return [Symbol, :"response.content_part.done"]
+        required :type, const: :"response.content_part.done"
+
+        # @!method initialize(content_index:, item_id:, output_index:, part:, sequence_number:, type: :"response.content_part.done")
+        #   Some parameter documentations has been truncated, see
+        #   {OpenAI::Models::Responses::ResponseContentPartDoneEvent} for more details.
+        #
+        #   Emitted when a content part is done.
+        #
+        #   @param content_index [Integer] The index of the content part that is done.
+        #
+        #   @param item_id [String] The ID of the output item that the content part was added to.
+        #
+        #   @param output_index [Integer] The index of the output item that the content part was added to.
+        #
+        #   @param part [OpenAI::Models::Responses::ResponseOutputText, OpenAI::Models::Responses::ResponseOutputRefusal] The content part that is done.
+        #
+        #   @param sequence_number [Integer] The sequence number of this event.
+        #
+        #   @param type [Symbol, :"response.content_part.done"] The type of the event. Always `response.content_part.done`.
+
+        # The content part that is done.
+        #
+        # @see OpenAI::Models::Responses::ResponseContentPartDoneEvent#part
+        module Part
+          extend OpenAI::Internal::Type::Union
+
+          discriminator :type
+
+          # A text output from the model.
+          variant :output_text, -> { OpenAI::Responses::ResponseOutputText }
+
+          # A refusal from the model.
+          variant :refusal, -> { OpenAI::Responses::ResponseOutputRefusal }
+
+          # @!method self.variants
+          #   @return [Array(OpenAI::Models::Responses::ResponseOutputText, OpenAI::Models::Responses::ResponseOutputRefusal)]
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/responses/response_create_params.rb

@@ -0,0 +1,369 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Responses
+      # @see OpenAI::Resources::Responses#create
+      #
+      # @see OpenAI::Resources::Responses#stream_raw
+      class ResponseCreateParams < OpenAI::Internal::Type::BaseModel
+        extend OpenAI::Internal::Type::RequestParameters::Converter
+        include OpenAI::Internal::Type::RequestParameters
+
+        # @!attribute input
+        #   Text, image, or file inputs to the model, used to generate a response.
+        #
+        #   Learn more:
+        #
+        #   - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+        #   - [Image inputs](https://platform.openai.com/docs/guides/images)
+        #   - [File inputs](https://platform.openai.com/docs/guides/pdf-files)
+        #   - [Conversation state](https://platform.openai.com/docs/guides/conversation-state)
+        #   - [Function calling](https://platform.openai.com/docs/guides/function-calling)
+        #
+        #   @return [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::ResponseReasoningItem, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::McpListTools, OpenAI::Models::Responses::ResponseInputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseInputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseInputItem::McpCall, OpenAI::Models::Responses::ResponseInputItem::ItemReference>]
+        required :input, union: -> { OpenAI::Responses::ResponseCreateParams::Input }
+
+        # @!attribute model
+        #   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://platform.openai.com/docs/models) to browse and compare
+        #   available models.
+        #
+        #   @return [String, Symbol, OpenAI::Models::ChatModel, OpenAI::Models::ResponsesModel::ResponsesOnlyModel]
+        required :model, union: -> { OpenAI::ResponsesModel }
+
+        # @!attribute background
+        #   Whether to run the model response in the background.
+        #   [Learn more](https://platform.openai.com/docs/guides/background).
+        #
+        #   @return [Boolean, nil]
+        optional :background, OpenAI::Internal::Type::Boolean, nil?: true
+
+        # @!attribute include
+        #   Specify additional output data to include in the model response. Currently
+        #   supported values are:
+        #
+        #   - `file_search_call.results`: Include the search results of the file search tool
+        #     call.
+        #   - `message.input_image.image_url`: Include image urls from the input message.
+        #   - `computer_call_output.output.image_url`: Include image urls from the computer
+        #     call output.
+        #   - `reasoning.encrypted_content`: Includes an encrypted version of reasoning
+        #     tokens in reasoning item outputs. This enables reasoning items to be used in
+        #     multi-turn conversations when using the Responses API statelessly (like when
+        #     the `store` parameter is set to `false`, or when an organization is enrolled
+        #     in the zero data retention program).
+        #
+        #   @return [Array<Symbol, OpenAI::Models::Responses::ResponseIncludable>, nil]
+        optional :include,
+                 -> { OpenAI::Internal::Type::ArrayOf[enum: OpenAI::Responses::ResponseIncludable] },
+                 nil?: true
+
+        # @!attribute instructions
+        #   Inserts a system (or developer) message as the first item in the model's
+        #   context.
+        #
+        #   When using 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.
+        #
+        #   @return [String, nil]
+        optional :instructions, String, nil?: true
+
+        # @!attribute max_output_tokens
+        #   An upper bound for the number of tokens that can be generated for a response,
+        #   including visible output tokens and
+        #   [reasoning tokens](https://platform.openai.com/docs/guides/reasoning).
+        #
+        #   @return [Integer, nil]
+        optional :max_output_tokens, Integer, nil?: true
+
+        # @!attribute metadata
+        #   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.
+        #
+        #   Keys are strings with a maximum length of 64 characters. Values are strings with
+        #   a maximum length of 512 characters.
+        #
+        #   @return [Hash{Symbol=>String}, nil]
+        optional :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true
+
+        # @!attribute parallel_tool_calls
+        #   Whether to allow the model to run tool calls in parallel.
+        #
+        #   @return [Boolean, nil]
+        optional :parallel_tool_calls, OpenAI::Internal::Type::Boolean, nil?: true
+
+        # @!attribute previous_response_id
+        #   The unique ID of the previous response to the model. Use this to create
+        #   multi-turn conversations. Learn more about
+        #   [conversation state](https://platform.openai.com/docs/guides/conversation-state).
+        #
+        #   @return [String, nil]
+        optional :previous_response_id, String, nil?: true
+
+        # @!attribute reasoning
+        #   **o-series models only**
+        #
+        #   Configuration options for
+        #   [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+        #
+        #   @return [OpenAI::Models::Reasoning, nil]
+        optional :reasoning, -> { OpenAI::Reasoning }, nil?: true
+
+        # @!attribute service_tier
+        #   Specifies the latency tier to use for processing the request. This parameter is
+        #   relevant for customers subscribed to the scale tier service:
+        #
+        #   - If set to 'auto', and the Project is Scale tier enabled, the system will
+        #     utilize scale tier credits until they are exhausted.
+        #   - If set to 'auto', and the Project is not Scale tier enabled, the request will
+        #     be processed using the default service tier with a lower uptime SLA and no
+        #     latency guarentee.
+        #   - If set to 'default', the request will be processed using the default service
+        #     tier with a lower uptime SLA and no latency guarentee.
+        #   - If set to 'flex', the request will be processed with the Flex Processing
+        #     service tier.
+        #     [Learn more](https://platform.openai.com/docs/guides/flex-processing).
+        #   - When not set, the default behavior is 'auto'.
+        #
+        #   When this parameter is set, the response body will include the `service_tier`
+        #   utilized.
+        #
+        #   @return [Symbol, OpenAI::Models::Responses::ResponseCreateParams::ServiceTier, nil]
+        optional :service_tier, enum: -> { OpenAI::Responses::ResponseCreateParams::ServiceTier }, nil?: true
+
+        # @!attribute store
+        #   Whether to store the generated model response for later retrieval via API.
+        #
+        #   @return [Boolean, nil]
+        optional :store, OpenAI::Internal::Type::Boolean, nil?: true
+
+        # @!attribute temperature
+        #   What sampling temperature to use, between 0 and 2. Higher values like 0.8 will
+        #   make the output more random, while lower values like 0.2 will make it more
+        #   focused and deterministic. We generally recommend altering this or `top_p` but
+        #   not both.
+        #
+        #   @return [Float, nil]
+        optional :temperature, Float, nil?: true
+
+        # @!attribute text
+        #   Configuration options for a text response from the model. Can be plain text or
+        #   structured JSON data. Learn more:
+        #
+        #   - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+        #   - [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs)
+        #
+        #   @return [OpenAI::Models::Responses::ResponseTextConfig, nil]
+        optional :text,
+                 union: -> {
+                   OpenAI::UnionOf[
+                     OpenAI::Responses::ResponseTextConfig,
+                     OpenAI::StructuredOutput::JsonSchemaConverter
+                   ]
+                 }
+
+        # @!attribute tool_choice
+        #   How the model should select which tool (or tools) to use when generating a
+        #   response. See the `tools` parameter to see how to specify which tools the model
+        #   can call.
+        #
+        #   @return [Symbol, OpenAI::Models::Responses::ToolChoiceOptions, OpenAI::Models::Responses::ToolChoiceTypes, OpenAI::Models::Responses::ToolChoiceFunction, nil]
+        optional :tool_choice, union: -> { OpenAI::Responses::ResponseCreateParams::ToolChoice }
+
+        # @!attribute tools
+        #   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.
+        #
+        #   The two categories of tools you can provide the model are:
+        #
+        #   - **Built-in tools**: Tools that are provided by OpenAI that extend the model's
+        #     capabilities, like
+        #     [web search](https://platform.openai.com/docs/guides/tools-web-search) or
+        #     [file search](https://platform.openai.com/docs/guides/tools-file-search).
+        #     Learn more about
+        #     [built-in tools](https://platform.openai.com/docs/guides/tools).
+        #   - **Function calls (custom tools)**: Functions that are defined by you, enabling
+        #     the model to call your own code. Learn more about
+        #     [function calling](https://platform.openai.com/docs/guides/function-calling).
+        #
+        #   @return [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::StructuredOutput::JsonSchemaConverter, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::WebSearchTool>, nil]
+        optional :tools, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::Tool] }
+
+        # @!attribute top_p
+        #   An alternative to sampling with temperature, called nucleus sampling, where the
+        #   model considers the results of the tokens with top_p probability mass. So 0.1
+        #   means only the tokens comprising the top 10% probability mass are considered.
+        #
+        #   We generally recommend altering this or `temperature` but not both.
+        #
+        #   @return [Float, nil]
+        optional :top_p, Float, nil?: true
+
+        # @!attribute truncation
+        #   The truncation strategy to use for the model response.
+        #
+        #   - `auto`: If the context of this response and previous ones exceeds the model's
+        #     context window size, the model will truncate the response to fit the context
+        #     window by dropping input items in the middle of the conversation.
+        #   - `disabled` (default): If a model response will exceed the context window size
+        #     for a model, the request will fail with a 400 error.
+        #
+        #   @return [Symbol, OpenAI::Models::Responses::ResponseCreateParams::Truncation, nil]
+        optional :truncation, enum: -> { OpenAI::Responses::ResponseCreateParams::Truncation }, nil?: true
+
+        # @!attribute user
+        #   A stable identifier for your end-users. Used to boost cache hit rates by better
+        #   bucketing similar requests and to help OpenAI detect and prevent abuse.
+        #   [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#end-user-ids).
+        #
+        #   @return [String, nil]
+        optional :user, String
+
+        # @!method initialize(input:, model:, background: nil, include: nil, instructions: nil, max_output_tokens: nil, metadata: nil, parallel_tool_calls: nil, previous_response_id: nil, reasoning: nil, service_tier: nil, store: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_p: nil, truncation: nil, user: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {OpenAI::Models::Responses::ResponseCreateParams} for more details.
+        #
+        #   @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::ResponseReasoningItem, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::McpListTools, OpenAI::Models::Responses::ResponseInputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseInputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseInputItem::McpCall, OpenAI::Models::Responses::ResponseInputItem::ItemReference>] Text, image, or file inputs to the model, used to generate a response.
+        #
+        #   @param model [String, Symbol, OpenAI::Models::ChatModel, OpenAI::Models::ResponsesModel::ResponsesOnlyModel] Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI
+        #
+        #   @param background [Boolean, nil] Whether to run the model response in the background.
+        #
+        #   @param include [Array<Symbol, OpenAI::Models::Responses::ResponseIncludable>, nil] Specify additional output data to include in the model response. Currently
+        #
+        #   @param instructions [String, nil] Inserts a system (or developer) message as the first item in the model's context
+        #
+        #   @param max_output_tokens [Integer, nil] An upper bound for the number of tokens that can be generated for a response, in
+        #
+        #   @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
+        #
+        #   @param parallel_tool_calls [Boolean, nil] Whether to allow the model to run tool calls in parallel.
+        #
+        #   @param previous_response_id [String, nil] The unique ID of the previous response to the model. Use this to
+        #
+        #   @param reasoning [OpenAI::Models::Reasoning, nil] **o-series models only**
+        #
+        #   @param service_tier [Symbol, OpenAI::Models::Responses::ResponseCreateParams::ServiceTier, nil] Specifies the latency tier to use for processing the request. This parameter is
+        #
+        #   @param store [Boolean, nil] Whether to store the generated model response for later retrieval via
+        #
+        #   @param temperature [Float, nil] What sampling temperature to use, between 0 and 2. Higher values like 0.8 will m
+        #
+        #   @param text [OpenAI::Models::Responses::ResponseTextConfig] Configuration options for a text response from the model. Can be plain
+        #
+        #   @param tool_choice [Symbol, OpenAI::Models::Responses::ToolChoiceOptions, OpenAI::Models::Responses::ToolChoiceTypes, OpenAI::Models::Responses::ToolChoiceFunction] How the model should select which tool (or tools) to use when generating
+        #
+        #   @param tools [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::StructuredOutput::JsonSchemaConverter, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::WebSearchTool>] An array of tools the model may call while generating a response. You
+        #
+        #   @param top_p [Float, nil] An alternative to sampling with temperature, called nucleus sampling,
+        #
+        #   @param truncation [Symbol, OpenAI::Models::Responses::ResponseCreateParams::Truncation, nil] The truncation strategy to use for the model response.
+        #
+        #   @param user [String] A stable identifier for your end-users.
+        #
+        #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+
+        # Text, image, or file inputs to the model, used to generate a response.
+        #
+        # Learn more:
+        #
+        # - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+        # - [Image inputs](https://platform.openai.com/docs/guides/images)
+        # - [File inputs](https://platform.openai.com/docs/guides/pdf-files)
+        # - [Conversation state](https://platform.openai.com/docs/guides/conversation-state)
+        # - [Function calling](https://platform.openai.com/docs/guides/function-calling)
+        module Input
+          extend OpenAI::Internal::Type::Union
+
+          # A text input to the model, equivalent to a text input with the
+          # `user` role.
+          variant String
+
+          # A list of one or many input items to the model, containing
+          # different content types.
+          variant -> { OpenAI::Responses::ResponseInput }
+
+          # @!method self.variants
+          #   @return [Array(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::ResponseReasoningItem, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::McpListTools, OpenAI::Models::Responses::ResponseInputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseInputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseInputItem::McpCall, OpenAI::Models::Responses::ResponseInputItem::ItemReference>)]
+        end
+
+        # Specifies the latency tier to use for processing the request. This parameter is
+        # relevant for customers subscribed to the scale tier service:
+        #
+        # - If set to 'auto', and the Project is Scale tier enabled, the system will
+        #   utilize scale tier credits until they are exhausted.
+        # - If set to 'auto', and the Project is not Scale tier enabled, the request will
+        #   be processed using the default service tier with a lower uptime SLA and no
+        #   latency guarentee.
+        # - If set to 'default', the request will be processed using the default service
+        #   tier with a lower uptime SLA and no latency guarentee.
+        # - If set to 'flex', the request will be processed with the Flex Processing
+        #   service tier.
+        #   [Learn more](https://platform.openai.com/docs/guides/flex-processing).
+        # - When not set, the default behavior is 'auto'.
+        #
+        # When this parameter is set, the response body will include the `service_tier`
+        # utilized.
+        module ServiceTier
+          extend OpenAI::Internal::Type::Enum
+
+          AUTO = :auto
+          DEFAULT = :default
+          FLEX = :flex
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # How the model should select which tool (or tools) to use when generating a
+        # response. See the `tools` parameter to see how to specify which tools the model
+        # can call.
+        module ToolChoice
+          extend OpenAI::Internal::Type::Union
+
+          # Controls which (if any) tool is called by the model.
+          #
+          # `none` means the model will not call any tool and instead generates a message.
+          #
+          # `auto` means the model can pick between generating a message or calling one or
+          # more tools.
+          #
+          # `required` means the model must call one or more tools.
+          variant enum: -> { OpenAI::Responses::ToolChoiceOptions }
+
+          # Indicates that the model should use a built-in tool to generate a response.
+          # [Learn more about built-in tools](https://platform.openai.com/docs/guides/tools).
+          variant -> { OpenAI::Responses::ToolChoiceTypes }
+
+          # Use this option to force the model to call a specific function.
+          variant -> { OpenAI::Responses::ToolChoiceFunction }
+
+          # @!method self.variants
+          #   @return [Array(Symbol, OpenAI::Models::Responses::ToolChoiceOptions, OpenAI::Models::Responses::ToolChoiceTypes, OpenAI::Models::Responses::ToolChoiceFunction)]
+        end
+
+        # The truncation strategy to use for the model response.
+        #
+        # - `auto`: If the context of this response and previous ones exceeds the model's
+        #   context window size, the model will truncate the response to fit the context
+        #   window by dropping input items in the middle of the conversation.
+        # - `disabled` (default): If a model response will exceed the context window size
+        #   for a model, the request will fail with a 400 error.
+        module Truncation
+          extend OpenAI::Internal::Type::Enum
+
+          AUTO = :auto
+          DISABLED = :disabled
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/responses/response_created_event.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Responses
+      class ResponseCreatedEvent < OpenAI::Internal::Type::BaseModel
+        # @!attribute response
+        #   The response that was created.
+        #
+        #   @return [OpenAI::Models::Responses::Response]
+        required :response, -> { OpenAI::Responses::Response }
+
+        # @!attribute sequence_number
+        #   The sequence number for this event.
+        #
+        #   @return [Integer]
+        required :sequence_number, Integer
+
+        # @!attribute type
+        #   The type of the event. Always `response.created`.
+        #
+        #   @return [Symbol, :"response.created"]
+        required :type, const: :"response.created"
+
+        # @!method initialize(response:, sequence_number:, type: :"response.created")
+        #   Some parameter documentations has been truncated, see
+        #   {OpenAI::Models::Responses::ResponseCreatedEvent} for more details.
+        #
+        #   An event that is emitted when a response is created.
+        #
+        #   @param response [OpenAI::Models::Responses::Response] The response that was created.
+        #
+        #   @param sequence_number [Integer] The sequence number for this event.
+        #
+        #   @param type [Symbol, :"response.created"] The type of the event. Always `response.created`.
+      end
+    end
+  end
+end

data/lib/openai/models/responses/response_delete_params.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Responses
+      # @see OpenAI::Resources::Responses#delete
+      class ResponseDeleteParams < OpenAI::Internal::Type::BaseModel
+        extend OpenAI::Internal::Type::RequestParameters::Converter
+        include OpenAI::Internal::Type::RequestParameters
+
+        # @!method initialize(request_options: {})
+        #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/openai/models/responses/response_error.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Responses
+      class ResponseError < OpenAI::Internal::Type::BaseModel
+        # @!attribute code
+        #   The error code for the response.
+        #
+        #   @return [Symbol, OpenAI::Models::Responses::ResponseError::Code]
+        required :code, enum: -> { OpenAI::Responses::ResponseError::Code }
+
+        # @!attribute message
+        #   A human-readable description of the error.
+        #
+        #   @return [String]
+        required :message, String
+
+        # @!method initialize(code:, message:)
+        #   Some parameter documentations has been truncated, see
+        #   {OpenAI::Models::Responses::ResponseError} for more details.
+        #
+        #   An error object returned when the model fails to generate a Response.
+        #
+        #   @param code [Symbol, OpenAI::Models::Responses::ResponseError::Code] The error code for the response.
+        #
+        #   @param message [String] A human-readable description of the error.
+
+        # The error code for the response.
+        #
+        # @see OpenAI::Models::Responses::ResponseError#code
+        module Code
+          extend OpenAI::Internal::Type::Enum
+
+          SERVER_ERROR = :server_error
+          RATE_LIMIT_EXCEEDED = :rate_limit_exceeded
+          INVALID_PROMPT = :invalid_prompt
+          VECTOR_STORE_TIMEOUT = :vector_store_timeout
+          INVALID_IMAGE = :invalid_image
+          INVALID_IMAGE_FORMAT = :invalid_image_format
+          INVALID_BASE64_IMAGE = :invalid_base64_image
+          INVALID_IMAGE_URL = :invalid_image_url
+          IMAGE_TOO_LARGE = :image_too_large
+          IMAGE_TOO_SMALL = :image_too_small
+          IMAGE_PARSE_ERROR = :image_parse_error
+          IMAGE_CONTENT_POLICY_VIOLATION = :image_content_policy_violation
+          INVALID_IMAGE_MODE = :invalid_image_mode
+          IMAGE_FILE_TOO_LARGE = :image_file_too_large
+          UNSUPPORTED_IMAGE_MEDIA_TYPE = :unsupported_image_media_type
+          EMPTY_IMAGE_FILE = :empty_image_file
+          FAILED_TO_DOWNLOAD_IMAGE = :failed_to_download_image
+          IMAGE_FILE_NOT_FOUND = :image_file_not_found
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end