openai 0.8.0 → 0.10.0

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

@@ -5,19 +5,26 @@ module OpenAI
     module Responses
       class ResponseCodeInterpreterCallCodeDeltaEvent < OpenAI::Internal::Type::BaseModel
         # @!attribute delta
-        #   The partial code snippet added by the code interpreter.
+        #   The partial code snippet being streamed by the code interpreter.
         #
         #   @return [String]
         required :delta, String
 
+        # @!attribute item_id
+        #   The unique identifier of the code interpreter tool call item.
+        #
+        #   @return [String]
+        required :item_id, String
+
         # @!attribute output_index
-        #   The index of the output item that the code interpreter call is in progress.
+        #   The index of the output item in the response for which the code is being
+        #   streamed.
         #
         #   @return [Integer]
         required :output_index, Integer
 
         # @!attribute sequence_number
-        #   The sequence number of this event.
+        #   The sequence number of this event, used to order streaming events.
         #
         #   @return [Integer]
         required :sequence_number, Integer
@@ -28,18 +35,20 @@ module OpenAI
         #   @return [Symbol, :"response.code_interpreter_call_code.delta"]
         required :type, const: :"response.code_interpreter_call_code.delta"
 
-        # @!method initialize(delta:, output_index:, sequence_number:, type: :"response.code_interpreter_call_code.delta")
+        # @!method initialize(delta:, item_id:, output_index:, sequence_number:, type: :"response.code_interpreter_call_code.delta")
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Responses::ResponseCodeInterpreterCallCodeDeltaEvent} for more
         #   details.
         #
-        #   Emitted when a partial code snippet is added by the code interpreter.
+        #   Emitted when a partial code snippet is streamed by the code interpreter.
+        #
+        #   @param delta [String] The partial code snippet being streamed by the code interpreter.
         #
-        #   @param delta [String] The partial code snippet added by the code interpreter.
+        #   @param item_id [String] The unique identifier of the code interpreter tool call item.
         #
-        #   @param output_index [Integer] The index of the output item that the code interpreter call is in progress.
+        #   @param output_index [Integer] The index of the output item in the response for which the code is being streame
         #
-        #   @param sequence_number [Integer] The sequence number of this event.
+        #   @param sequence_number [Integer] The sequence number of this event, used to order streaming events.
         #
         #   @param type [Symbol, :"response.code_interpreter_call_code.delta"] The type of the event. Always `response.code_interpreter_call_code.delta`.
       end

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

@@ -10,14 +10,20 @@ module OpenAI
         #   @return [String]
         required :code, String
 
+        # @!attribute item_id
+        #   The unique identifier of the code interpreter tool call item.
+        #
+        #   @return [String]
+        required :item_id, String
+
         # @!attribute output_index
-        #   The index of the output item that the code interpreter call is in progress.
+        #   The index of the output item in the response for which the code is finalized.
         #
         #   @return [Integer]
         required :output_index, Integer
 
         # @!attribute sequence_number
-        #   The sequence number of this event.
+        #   The sequence number of this event, used to order streaming events.
         #
         #   @return [Integer]
         required :sequence_number, Integer
@@ -28,18 +34,16 @@ module OpenAI
         #   @return [Symbol, :"response.code_interpreter_call_code.done"]
         required :type, const: :"response.code_interpreter_call_code.done"
 
-        # @!method initialize(code:, output_index:, sequence_number:, type: :"response.code_interpreter_call_code.done")
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Responses::ResponseCodeInterpreterCallCodeDoneEvent} for more
-        #   details.
-        #
-        #   Emitted when code snippet output is finalized by the code interpreter.
+        # @!method initialize(code:, item_id:, output_index:, sequence_number:, type: :"response.code_interpreter_call_code.done")
+        #   Emitted when the code snippet is finalized by the code interpreter.
         #
         #   @param code [String] The final code snippet output by the code interpreter.
         #
-        #   @param output_index [Integer] The index of the output item that the code interpreter call is in progress.
+        #   @param item_id [String] The unique identifier of the code interpreter tool call item.
+        #
+        #   @param output_index [Integer] The index of the output item in the response for which the code is finalized.
         #
-        #   @param sequence_number [Integer] The sequence number of this event.
+        #   @param sequence_number [Integer] The sequence number of this event, used to order streaming events.
         #
         #   @param type [Symbol, :"response.code_interpreter_call_code.done"] The type of the event. Always `response.code_interpreter_call_code.done`.
       end

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

@@ -4,20 +4,21 @@ module OpenAI
   module Models
     module Responses
       class ResponseCodeInterpreterCallCompletedEvent < OpenAI::Internal::Type::BaseModel
-        # @!attribute code_interpreter_call
-        #   A tool call to run code.
+        # @!attribute item_id
+        #   The unique identifier of the code interpreter tool call item.
         #
-        #   @return [OpenAI::Models::Responses::ResponseCodeInterpreterToolCall]
-        required :code_interpreter_call, -> { OpenAI::Responses::ResponseCodeInterpreterToolCall }
+        #   @return [String]
+        required :item_id, String
 
         # @!attribute output_index
-        #   The index of the output item that the code interpreter call is in progress.
+        #   The index of the output item in the response for which the code interpreter call
+        #   is completed.
         #
         #   @return [Integer]
         required :output_index, Integer
 
         # @!attribute sequence_number
-        #   The sequence number of this event.
+        #   The sequence number of this event, used to order streaming events.
         #
         #   @return [Integer]
         required :sequence_number, Integer
@@ -28,18 +29,18 @@ module OpenAI
         #   @return [Symbol, :"response.code_interpreter_call.completed"]
         required :type, const: :"response.code_interpreter_call.completed"
 
-        # @!method initialize(code_interpreter_call:, output_index:, sequence_number:, type: :"response.code_interpreter_call.completed")
+        # @!method initialize(item_id:, output_index:, sequence_number:, type: :"response.code_interpreter_call.completed")
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Responses::ResponseCodeInterpreterCallCompletedEvent} for more
         #   details.
         #
         #   Emitted when the code interpreter call is completed.
         #
-        #   @param code_interpreter_call [OpenAI::Models::Responses::ResponseCodeInterpreterToolCall] A tool call to run code.
+        #   @param item_id [String] The unique identifier of the code interpreter tool call item.
         #
-        #   @param output_index [Integer] The index of the output item that the code interpreter call is in progress.
+        #   @param output_index [Integer] The index of the output item in the response for which the code interpreter call
         #
-        #   @param sequence_number [Integer] The sequence number of this event.
+        #   @param sequence_number [Integer] The sequence number of this event, used to order streaming events.
         #
         #   @param type [Symbol, :"response.code_interpreter_call.completed"] The type of the event. Always `response.code_interpreter_call.completed`.
       end

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

@@ -4,20 +4,21 @@ module OpenAI
   module Models
     module Responses
       class ResponseCodeInterpreterCallInProgressEvent < OpenAI::Internal::Type::BaseModel
-        # @!attribute code_interpreter_call
-        #   A tool call to run code.
+        # @!attribute item_id
+        #   The unique identifier of the code interpreter tool call item.
         #
-        #   @return [OpenAI::Models::Responses::ResponseCodeInterpreterToolCall]
-        required :code_interpreter_call, -> { OpenAI::Responses::ResponseCodeInterpreterToolCall }
+        #   @return [String]
+        required :item_id, String
 
         # @!attribute output_index
-        #   The index of the output item that the code interpreter call is in progress.
+        #   The index of the output item in the response for which the code interpreter call
+        #   is in progress.
         #
         #   @return [Integer]
         required :output_index, Integer
 
         # @!attribute sequence_number
-        #   The sequence number of this event.
+        #   The sequence number of this event, used to order streaming events.
         #
         #   @return [Integer]
         required :sequence_number, Integer
@@ -28,18 +29,18 @@ module OpenAI
         #   @return [Symbol, :"response.code_interpreter_call.in_progress"]
         required :type, const: :"response.code_interpreter_call.in_progress"
 
-        # @!method initialize(code_interpreter_call:, output_index:, sequence_number:, type: :"response.code_interpreter_call.in_progress")
+        # @!method initialize(item_id:, output_index:, sequence_number:, type: :"response.code_interpreter_call.in_progress")
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Responses::ResponseCodeInterpreterCallInProgressEvent} for more
         #   details.
         #
         #   Emitted when a code interpreter call is in progress.
         #
-        #   @param code_interpreter_call [OpenAI::Models::Responses::ResponseCodeInterpreterToolCall] A tool call to run code.
+        #   @param item_id [String] The unique identifier of the code interpreter tool call item.
         #
-        #   @param output_index [Integer] The index of the output item that the code interpreter call is in progress.
+        #   @param output_index [Integer] The index of the output item in the response for which the code interpreter call
         #
-        #   @param sequence_number [Integer] The sequence number of this event.
+        #   @param sequence_number [Integer] The sequence number of this event, used to order streaming events.
         #
         #   @param type [Symbol, :"response.code_interpreter_call.in_progress"] The type of the event. Always `response.code_interpreter_call.in_progress`.
       end

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

@@ -4,20 +4,21 @@ module OpenAI
   module Models
     module Responses
       class ResponseCodeInterpreterCallInterpretingEvent < OpenAI::Internal::Type::BaseModel
-        # @!attribute code_interpreter_call
-        #   A tool call to run code.
+        # @!attribute item_id
+        #   The unique identifier of the code interpreter tool call item.
         #
-        #   @return [OpenAI::Models::Responses::ResponseCodeInterpreterToolCall]
-        required :code_interpreter_call, -> { OpenAI::Responses::ResponseCodeInterpreterToolCall }
+        #   @return [String]
+        required :item_id, String
 
         # @!attribute output_index
-        #   The index of the output item that the code interpreter call is in progress.
+        #   The index of the output item in the response for which the code interpreter is
+        #   interpreting code.
         #
         #   @return [Integer]
         required :output_index, Integer
 
         # @!attribute sequence_number
-        #   The sequence number of this event.
+        #   The sequence number of this event, used to order streaming events.
         #
         #   @return [Integer]
         required :sequence_number, Integer
@@ -28,18 +29,18 @@ module OpenAI
         #   @return [Symbol, :"response.code_interpreter_call.interpreting"]
         required :type, const: :"response.code_interpreter_call.interpreting"
 
-        # @!method initialize(code_interpreter_call:, output_index:, sequence_number:, type: :"response.code_interpreter_call.interpreting")
+        # @!method initialize(item_id:, output_index:, sequence_number:, type: :"response.code_interpreter_call.interpreting")
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Responses::ResponseCodeInterpreterCallInterpretingEvent} for
         #   more details.
         #
         #   Emitted when the code interpreter is actively interpreting the code snippet.
         #
-        #   @param code_interpreter_call [OpenAI::Models::Responses::ResponseCodeInterpreterToolCall] A tool call to run code.
+        #   @param item_id [String] The unique identifier of the code interpreter tool call item.
         #
-        #   @param output_index [Integer] The index of the output item that the code interpreter call is in progress.
+        #   @param output_index [Integer] The index of the output item in the response for which the code interpreter is i
         #
-        #   @param sequence_number [Integer] The sequence number of this event.
+        #   @param sequence_number [Integer] The sequence number of this event, used to order streaming events.
         #
         #   @param type [Symbol, :"response.code_interpreter_call.interpreting"] The type of the event. Always `response.code_interpreter_call.interpreting`.
       end

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

@@ -11,19 +11,27 @@ module OpenAI
         required :id, String
 
         # @!attribute code
-        #   The code to run.
+        #   The code to run, or null if not available.
+        #
+        #   @return [String, nil]
+        required :code, String, nil?: true
+
+        # @!attribute container_id
+        #   The ID of the container used to run the code.
         #
         #   @return [String]
-        required :code, String
+        required :container_id, String
 
-        # @!attribute results
-        #   The results of the code interpreter tool call.
+        # @!attribute outputs
+        #   The outputs generated by the code interpreter, such as logs or images. Can be
+        #   null if no outputs are available.
         #
-        #   @return [Array<OpenAI::Models::Responses::ResponseCodeInterpreterToolCall::Result::Logs, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall::Result::Files>]
-        required :results,
+        #   @return [Array<OpenAI::Models::Responses::ResponseCodeInterpreterToolCall::Output::Logs, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall::Output::Image>, nil]
+        required :outputs,
                  -> {
-                   OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::ResponseCodeInterpreterToolCall::Result]
-                 }
+                   OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::ResponseCodeInterpreterToolCall::Output]
+                 },
+                 nil?: true
 
         # @!attribute status
         #   The status of the code interpreter tool call.
@@ -37,13 +45,7 @@ module OpenAI
         #   @return [Symbol, :code_interpreter_call]
         required :type, const: :code_interpreter_call
 
-        # @!attribute container_id
-        #   The ID of the container used to run the code.
-        #
-        #   @return [String, nil]
-        optional :container_id, String
-
-        # @!method initialize(id:, code:, results:, status:, container_id: nil, type: :code_interpreter_call)
+        # @!method initialize(id:, code:, container_id:, outputs:, status:, type: :code_interpreter_call)
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Responses::ResponseCodeInterpreterToolCall} for more details.
         #
@@ -51,105 +53,72 @@ module OpenAI
         #
         #   @param id [String] The unique ID of the code interpreter tool call.
         #
-        #   @param code [String] The code to run.
+        #   @param code [String, nil] The code to run, or null if not available.
         #
-        #   @param results [Array<OpenAI::Models::Responses::ResponseCodeInterpreterToolCall::Result::Logs, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall::Result::Files>] The results of the code interpreter tool call.
+        #   @param container_id [String] The ID of the container used to run the code.
         #
-        #   @param status [Symbol, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall::Status] The status of the code interpreter tool call.
+        #   @param outputs [Array<OpenAI::Models::Responses::ResponseCodeInterpreterToolCall::Output::Logs, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall::Output::Image>, nil] The outputs generated by the code interpreter, such as logs or images.
         #
-        #   @param container_id [String] The ID of the container used to run the code.
+        #   @param status [Symbol, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall::Status] The status of the code interpreter tool call.
         #
         #   @param type [Symbol, :code_interpreter_call] The type of the code interpreter tool call. Always `code_interpreter_call`.
 
-        # The output of a code interpreter tool.
-        module Result
+        # The logs output from the code interpreter.
+        module Output
           extend OpenAI::Internal::Type::Union
 
           discriminator :type
 
-          # The output of a code interpreter tool call that is text.
-          variant :logs, -> { OpenAI::Responses::ResponseCodeInterpreterToolCall::Result::Logs }
+          # The logs output from the code interpreter.
+          variant :logs, -> { OpenAI::Responses::ResponseCodeInterpreterToolCall::Output::Logs }
 
-          # The output of a code interpreter tool call that is a file.
-          variant :files, -> { OpenAI::Responses::ResponseCodeInterpreterToolCall::Result::Files }
+          # The image output from the code interpreter.
+          variant :image, -> { OpenAI::Responses::ResponseCodeInterpreterToolCall::Output::Image }
 
           class Logs < OpenAI::Internal::Type::BaseModel
             # @!attribute logs
-            #   The logs of the code interpreter tool call.
+            #   The logs output from the code interpreter.
             #
             #   @return [String]
             required :logs, String
 
             # @!attribute type
-            #   The type of the code interpreter text output. Always `logs`.
+            #   The type of the output. Always 'logs'.
             #
             #   @return [Symbol, :logs]
             required :type, const: :logs
 
             # @!method initialize(logs:, type: :logs)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Responses::ResponseCodeInterpreterToolCall::Result::Logs} for
-            #   more details.
+            #   The logs output from the code interpreter.
             #
-            #   The output of a code interpreter tool call that is text.
+            #   @param logs [String] The logs output from the code interpreter.
             #
-            #   @param logs [String] The logs of the code interpreter tool call.
-            #
-            #   @param type [Symbol, :logs] The type of the code interpreter text output. Always `logs`.
+            #   @param type [Symbol, :logs] The type of the output. Always 'logs'.
           end
 
-          class Files < OpenAI::Internal::Type::BaseModel
-            # @!attribute files
-            #
-            #   @return [Array<OpenAI::Models::Responses::ResponseCodeInterpreterToolCall::Result::Files::File>]
-            required :files,
-                     -> {
-                       OpenAI::Internal::Type::ArrayOf[OpenAI::Responses::ResponseCodeInterpreterToolCall::Result::Files::File]
-                     }
-
+          class Image < OpenAI::Internal::Type::BaseModel
             # @!attribute type
-            #   The type of the code interpreter file output. Always `files`.
+            #   The type of the output. Always 'image'.
             #
-            #   @return [Symbol, :files]
-            required :type, const: :files
+            #   @return [Symbol, :image]
+            required :type, const: :image
 
-            # @!method initialize(files:, type: :files)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Responses::ResponseCodeInterpreterToolCall::Result::Files} for
-            #   more details.
+            # @!attribute url
+            #   The URL of the image output from the code interpreter.
             #
-            #   The output of a code interpreter tool call that is a file.
+            #   @return [String]
+            required :url, String
+
+            # @!method initialize(url:, type: :image)
+            #   The image output from the code interpreter.
             #
-            #   @param files [Array<OpenAI::Models::Responses::ResponseCodeInterpreterToolCall::Result::Files::File>]
+            #   @param url [String] The URL of the image output from the code interpreter.
             #
-            #   @param type [Symbol, :files] The type of the code interpreter file output. Always `files`.
-
-            class File < OpenAI::Internal::Type::BaseModel
-              # @!attribute file_id
-              #   The ID of the file.
-              #
-              #   @return [String]
-              required :file_id, String
-
-              # @!attribute mime_type
-              #   The MIME type of the file.
-              #
-              #   @return [String]
-              required :mime_type, String
-
-              # @!method initialize(file_id:, mime_type:)
-              #   Some parameter documentations has been truncated, see
-              #   {OpenAI::Models::Responses::ResponseCodeInterpreterToolCall::Result::Files::File}
-              #   for more details.
-              #
-              #   @param file_id [String] The ID of the file.
-              #
-              #   @param mime_type [String] The MIME type of the file.
-            end
+            #   @param type [Symbol, :image] The type of the output. Always 'image'.
           end
 
           # @!method self.variants
-          #   @return [Array(OpenAI::Models::Responses::ResponseCodeInterpreterToolCall::Result::Logs, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall::Result::Files)]
+          #   @return [Array(OpenAI::Models::Responses::ResponseCodeInterpreterToolCall::Output::Logs, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall::Output::Image)]
         end
 
         # The status of the code interpreter tool call.
@@ -159,8 +128,10 @@ module OpenAI
           extend OpenAI::Internal::Type::Enum
 
           IN_PROGRESS = :in_progress
-          INTERPRETING = :interpreting
           COMPLETED = :completed
+          INCOMPLETE = :incomplete
+          INTERPRETING = :interpreting
+          FAILED = :failed
 
           # @!method self.values
           #   @return [Array<Symbol>]

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

@@ -10,30 +10,6 @@ module OpenAI
         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).
@@ -63,9 +39,22 @@ module OpenAI
                  -> { OpenAI::Internal::Type::ArrayOf[enum: OpenAI::Responses::ResponseIncludable] },
                  nil?: true
 
+        # @!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>, nil]
+        optional :input, union: -> { OpenAI::Responses::ResponseCreateParams::Input }
+
         # @!attribute instructions
-        #   Inserts a system (or developer) message as the first item in the model's
-        #   context.
+        #   A system (or developer) message inserted into 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
@@ -93,6 +82,16 @@ module OpenAI
         #   @return [Hash{Symbol=>String}, nil]
         optional :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true
 
+        # @!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, nil]
+        optional :model, union: -> { OpenAI::ResponsesModel }
+
         # @!attribute parallel_tool_calls
         #   Whether to allow the model to run tool calls in parallel.
         #
@@ -107,6 +106,13 @@ module OpenAI
         #   @return [String, nil]
         optional :previous_response_id, String, nil?: true
 
+        # @!attribute prompt
+        #   Reference to a prompt template and its variables.
+        #   [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
+        #
+        #   @return [OpenAI::Models::Responses::ResponsePrompt, nil]
+        optional :prompt, -> { OpenAI::Responses::ResponsePrompt }, nil?: true
+
         # @!attribute reasoning
         #   **o-series models only**
         #
@@ -226,28 +232,30 @@ module OpenAI
         #   @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: {})
+        # @!method initialize(background: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, metadata: nil, model: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: 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 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 instructions [String, nil] A system (or developer) message inserted into 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 model [String, Symbol, OpenAI::Models::ChatModel, OpenAI::Models::ResponsesModel::ResponsesOnlyModel] Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI
+        #
         #   @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 prompt [OpenAI::Models::Responses::ResponsePrompt, nil] Reference to a prompt template and its variables.
+        #
         #   @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
@@ -317,6 +325,7 @@ module OpenAI
           AUTO = :auto
           DEFAULT = :default
           FLEX = :flex
+          SCALE = :scale
 
           # @!method self.values
           #   @return [Array<Symbol>]