openai 0.7.0 → 0.9.0

data/lib/openai/resources/fine_tuning/checkpoints/permissions.rb

@@ -60,7 +60,7 @@ module OpenAI
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
-          # @return [OpenAI::Models::FineTuning::Checkpoints::PermissionRetrieveResponse]
+          # @return [OpenAI::Internal::CursorPage<OpenAI::Models::FineTuning::Checkpoints::PermissionRetrieveResponse>]
           #
           # @see OpenAI::Models::FineTuning::Checkpoints::PermissionRetrieveParams
           def retrieve(fine_tuned_model_checkpoint, params = {})
@@ -69,6 +69,7 @@ module OpenAI
               method: :get,
               path: ["fine_tuning/checkpoints/%1$s/permissions", fine_tuned_model_checkpoint],
               query: parsed,
+              page: OpenAI::Internal::CursorPage,
               model: OpenAI::Models::FineTuning::Checkpoints::PermissionRetrieveResponse,
               options: options
             )

data/lib/openai/resources/fine_tuning/jobs.rb

@@ -16,7 +16,7 @@ module OpenAI
         # Response includes details of the enqueued job including job status and the name
         # of the fine-tuned models once complete.
         #
-        # [Learn more about fine-tuning](https://platform.openai.com/docs/guides/fine-tuning)
+        # [Learn more about fine-tuning](https://platform.openai.com/docs/guides/model-optimization)
         #
         # @overload create(model:, training_file:, hyperparameters: nil, integrations: nil, metadata: nil, method_: nil, seed: nil, suffix: nil, validation_file: nil, request_options: {})
         #
@@ -59,7 +59,7 @@ module OpenAI
         #
         # Get info about a fine-tuning job.
         #
-        # [Learn more about fine-tuning](https://platform.openai.com/docs/guides/fine-tuning)
+        # [Learn more about fine-tuning](https://platform.openai.com/docs/guides/model-optimization)
         #
         # @overload retrieve(fine_tuning_job_id, request_options: {})
         #

data/lib/openai/resources/images.rb

@@ -45,7 +45,7 @@ module OpenAI
       # Creates an edited or extended image given one or more source images and a
       # prompt. This endpoint only supports `gpt-image-1` and `dall-e-2`.
       #
-      # @overload edit(image:, prompt:, background: nil, mask: nil, model: nil, n: nil, quality: nil, response_format: nil, size: nil, user: nil, request_options: {})
+      # @overload edit(image:, prompt:, background: nil, mask: nil, model: nil, n: nil, output_compression: nil, output_format: nil, quality: nil, response_format: nil, size: nil, user: nil, request_options: {})
       #
       # @param image [Pathname, StringIO, IO, String, OpenAI::FilePart, Array<Pathname, StringIO, IO, String, OpenAI::FilePart>] The image(s) to edit. Must be a supported image file or an array of images.
       #
@@ -59,6 +59,10 @@ module OpenAI
       #
       # @param n [Integer, nil] The number of images to generate. Must be between 1 and 10.
       #
+      # @param output_compression [Integer, nil] The compression level (0-100%) for the generated images. This parameter
+      #
+      # @param output_format [Symbol, OpenAI::Models::ImageEditParams::OutputFormat, nil] The format in which the generated images are returned. This parameter is
+      #
       # @param quality [Symbol, OpenAI::Models::ImageEditParams::Quality, nil] The quality of the image that will be generated. `high`, `medium` and `low` are
       #
       # @param response_format [Symbol, OpenAI::Models::ImageEditParams::ResponseFormat, nil] The format in which the generated images are returned. Must be one of `url` or `

data/lib/openai/resources/responses.rb

@@ -23,7 +23,7 @@ module OpenAI
       # [file search](https://platform.openai.com/docs/guides/tools-file-search) to use
       # your own data as input for the model's response.
       #
-      # @overload create(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: {})
+      # @overload create(input:, model:, background: nil, include: nil, instructions: nil, max_output_tokens: nil, metadata: 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: {})
       #
       # @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.
       #
@@ -33,7 +33,7 @@ module OpenAI
       #
       # @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 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
       #
@@ -43,6 +43,8 @@ module OpenAI
       #
       # @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
@@ -181,7 +183,7 @@ module OpenAI
       # [file search](https://platform.openai.com/docs/guides/tools-file-search) to use
       # your own data as input for the model's response.
       #
-      # @overload stream_raw(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: {})
+      # @overload stream_raw(input:, model:, background: nil, include: nil, instructions: nil, max_output_tokens: nil, metadata: 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: {})
       #
       # @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.
       #
@@ -191,7 +193,7 @@ module OpenAI
       #
       # @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 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
       #
@@ -201,6 +203,8 @@ module OpenAI
       #
       # @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

data/lib/openai/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OpenAI
-  VERSION = "0.7.0"
+  VERSION = "0.9.0"
 end

data/lib/openai.rb

@@ -416,6 +416,7 @@ require_relative "openai/models/responses/response_output_message"
 require_relative "openai/models/responses/response_output_refusal"
 require_relative "openai/models/responses/response_output_text"
 require_relative "openai/models/responses/response_output_text_annotation_added_event"
+require_relative "openai/models/responses/response_prompt"
 require_relative "openai/models/responses/response_queued_event"
 require_relative "openai/models/responses/response_reasoning_delta_event"
 require_relative "openai/models/responses/response_reasoning_done_event"

data/rbi/openai/models/all_models.rbi

@@ -28,6 +28,13 @@ module OpenAI
             :"o1-pro-2025-03-19",
             OpenAI::AllModels::ResponsesOnlyModel::TaggedSymbol
           )
+        O3_PRO =
+          T.let(:"o3-pro", OpenAI::AllModels::ResponsesOnlyModel::TaggedSymbol)
+        O3_PRO_2025_06_10 =
+          T.let(
+            :"o3-pro-2025-06-10",
+            OpenAI::AllModels::ResponsesOnlyModel::TaggedSymbol
+          )
         COMPUTER_USE_PREVIEW =
           T.let(
             :"computer-use-preview",

data/rbi/openai/models/chat/chat_completion.rbi

@@ -404,6 +404,11 @@ module OpenAI
               :flex,
               OpenAI::Chat::ChatCompletion::ServiceTier::TaggedSymbol
             )
+          SCALE =
+            T.let(
+              :scale,
+              OpenAI::Chat::ChatCompletion::ServiceTier::TaggedSymbol
+            )
 
           sig do
             override.returns(

data/rbi/openai/models/chat/chat_completion_chunk.rbi

@@ -824,6 +824,11 @@ module OpenAI
               :flex,
               OpenAI::Chat::ChatCompletionChunk::ServiceTier::TaggedSymbol
             )
+          SCALE =
+            T.let(
+              :scale,
+              OpenAI::Chat::ChatCompletionChunk::ServiceTier::TaggedSymbol
+            )
 
           sig do
             override.returns(

data/rbi/openai/models/chat/completion_create_params.rbi

@@ -1049,6 +1049,11 @@ module OpenAI
               :flex,
               OpenAI::Chat::CompletionCreateParams::ServiceTier::TaggedSymbol
             )
+          SCALE =
+            T.let(
+              :scale,
+              OpenAI::Chat::CompletionCreateParams::ServiceTier::TaggedSymbol
+            )
 
           sig do
             override.returns(

data/rbi/openai/models/fine_tuning/checkpoints/permission_retrieve_response.rbi

@@ -13,125 +13,56 @@ module OpenAI
               )
             end
 
-          sig do
-            returns(
-              T::Array[
-                OpenAI::Models::FineTuning::Checkpoints::PermissionRetrieveResponse::Data
-              ]
-            )
-          end
-          attr_accessor :data
+          # The permission identifier, which can be referenced in the API endpoints.
+          sig { returns(String) }
+          attr_accessor :id
 
-          sig { returns(T::Boolean) }
-          attr_accessor :has_more
+          # The Unix timestamp (in seconds) for when the permission was created.
+          sig { returns(Integer) }
+          attr_accessor :created_at
 
+          # The object type, which is always "checkpoint.permission".
           sig { returns(Symbol) }
           attr_accessor :object
 
-          sig { returns(T.nilable(String)) }
-          attr_accessor :first_id
-
-          sig { returns(T.nilable(String)) }
-          attr_accessor :last_id
+          # The project identifier that the permission is for.
+          sig { returns(String) }
+          attr_accessor :project_id
 
+          # The `checkpoint.permission` object represents a permission for a fine-tuned
+          # model checkpoint.
           sig do
             params(
-              data:
-                T::Array[
-                  OpenAI::Models::FineTuning::Checkpoints::PermissionRetrieveResponse::Data::OrHash
-                ],
-              has_more: T::Boolean,
-              first_id: T.nilable(String),
-              last_id: T.nilable(String),
+              id: String,
+              created_at: Integer,
+              project_id: String,
               object: Symbol
             ).returns(T.attached_class)
           end
           def self.new(
-            data:,
-            has_more:,
-            first_id: nil,
-            last_id: nil,
-            object: :list
+            # The permission identifier, which can be referenced in the API endpoints.
+            id:,
+            # The Unix timestamp (in seconds) for when the permission was created.
+            created_at:,
+            # The project identifier that the permission is for.
+            project_id:,
+            # The object type, which is always "checkpoint.permission".
+            object: :"checkpoint.permission"
           )
           end
 
           sig do
             override.returns(
               {
-                data:
-                  T::Array[
-                    OpenAI::Models::FineTuning::Checkpoints::PermissionRetrieveResponse::Data
-                  ],
-                has_more: T::Boolean,
+                id: String,
+                created_at: Integer,
                 object: Symbol,
-                first_id: T.nilable(String),
-                last_id: T.nilable(String)
+                project_id: String
               }
             )
           end
           def to_hash
           end
-
-          class Data < OpenAI::Internal::Type::BaseModel
-            OrHash =
-              T.type_alias do
-                T.any(
-                  OpenAI::Models::FineTuning::Checkpoints::PermissionRetrieveResponse::Data,
-                  OpenAI::Internal::AnyHash
-                )
-              end
-
-            # The permission identifier, which can be referenced in the API endpoints.
-            sig { returns(String) }
-            attr_accessor :id
-
-            # The Unix timestamp (in seconds) for when the permission was created.
-            sig { returns(Integer) }
-            attr_accessor :created_at
-
-            # The object type, which is always "checkpoint.permission".
-            sig { returns(Symbol) }
-            attr_accessor :object
-
-            # The project identifier that the permission is for.
-            sig { returns(String) }
-            attr_accessor :project_id
-
-            # The `checkpoint.permission` object represents a permission for a fine-tuned
-            # model checkpoint.
-            sig do
-              params(
-                id: String,
-                created_at: Integer,
-                project_id: String,
-                object: Symbol
-              ).returns(T.attached_class)
-            end
-            def self.new(
-              # The permission identifier, which can be referenced in the API endpoints.
-              id:,
-              # The Unix timestamp (in seconds) for when the permission was created.
-              created_at:,
-              # The project identifier that the permission is for.
-              project_id:,
-              # The object type, which is always "checkpoint.permission".
-              object: :"checkpoint.permission"
-            )
-            end
-
-            sig do
-              override.returns(
-                {
-                  id: String,
-                  created_at: Integer,
-                  object: Symbol,
-                  project_id: String
-                }
-              )
-            end
-            def to_hash
-            end
-          end
         end
       end
     end

data/rbi/openai/models/fine_tuning/job_create_params.rbi

@@ -39,7 +39,8 @@ module OpenAI
         # [preference](https://platform.openai.com/docs/api-reference/fine-tuning/preference-input)
         # format.
         #
-        # See the [fine-tuning guide](https://platform.openai.com/docs/guides/fine-tuning)
+        # See the
+        # [fine-tuning guide](https://platform.openai.com/docs/guides/model-optimization)
         # for more details.
         sig { returns(String) }
         attr_accessor :training_file
@@ -115,7 +116,8 @@ module OpenAI
         # Your dataset must be formatted as a JSONL file. You must upload your file with
         # the purpose `fine-tune`.
         #
-        # See the [fine-tuning guide](https://platform.openai.com/docs/guides/fine-tuning)
+        # See the
+        # [fine-tuning guide](https://platform.openai.com/docs/guides/model-optimization)
         # for more details.
         sig { returns(T.nilable(String)) }
         attr_accessor :validation_file
@@ -163,7 +165,8 @@ module OpenAI
           # [preference](https://platform.openai.com/docs/api-reference/fine-tuning/preference-input)
           # format.
           #
-          # See the [fine-tuning guide](https://platform.openai.com/docs/guides/fine-tuning)
+          # See the
+          # [fine-tuning guide](https://platform.openai.com/docs/guides/model-optimization)
           # for more details.
           training_file:,
           # The hyperparameters used for the fine-tuning job. This value is now deprecated
@@ -200,7 +203,8 @@ module OpenAI
           # Your dataset must be formatted as a JSONL file. You must upload your file with
           # the purpose `fine-tune`.
           #
-          # See the [fine-tuning guide](https://platform.openai.com/docs/guides/fine-tuning)
+          # See the
+          # [fine-tuning guide](https://platform.openai.com/docs/guides/model-optimization)
           # for more details.
           validation_file: nil,
           request_options: {}

data/rbi/openai/models/image_edit_params.rbi

@@ -56,6 +56,20 @@ module OpenAI
       sig { returns(T.nilable(Integer)) }
       attr_accessor :n
 
+      # The compression level (0-100%) for the generated images. This parameter is only
+      # supported for `gpt-image-1` with the `webp` or `jpeg` output formats, and
+      # defaults to 100.
+      sig { returns(T.nilable(Integer)) }
+      attr_accessor :output_compression
+
+      # The format in which the generated images are returned. This parameter is only
+      # supported for `gpt-image-1`. Must be one of `png`, `jpeg`, or `webp`. The
+      # default value is `png`.
+      sig do
+        returns(T.nilable(OpenAI::ImageEditParams::OutputFormat::OrSymbol))
+      end
+      attr_accessor :output_format
+
       # The quality of the image that will be generated. `high`, `medium` and `low` are
       # only supported for `gpt-image-1`. `dall-e-2` only supports `standard` quality.
       # Defaults to `auto`.
@@ -94,6 +108,9 @@ module OpenAI
           mask: OpenAI::Internal::FileInput,
           model: T.nilable(T.any(String, OpenAI::ImageModel::OrSymbol)),
           n: T.nilable(Integer),
+          output_compression: T.nilable(Integer),
+          output_format:
+            T.nilable(OpenAI::ImageEditParams::OutputFormat::OrSymbol),
           quality: T.nilable(OpenAI::ImageEditParams::Quality::OrSymbol),
           response_format:
             T.nilable(OpenAI::ImageEditParams::ResponseFormat::OrSymbol),
@@ -133,6 +150,14 @@ module OpenAI
         model: nil,
         # The number of images to generate. Must be between 1 and 10.
         n: nil,
+        # The compression level (0-100%) for the generated images. This parameter is only
+        # supported for `gpt-image-1` with the `webp` or `jpeg` output formats, and
+        # defaults to 100.
+        output_compression: nil,
+        # The format in which the generated images are returned. This parameter is only
+        # supported for `gpt-image-1`. Must be one of `png`, `jpeg`, or `webp`. The
+        # default value is `png`.
+        output_format: nil,
         # The quality of the image that will be generated. `high`, `medium` and `low` are
         # only supported for `gpt-image-1`. `dall-e-2` only supports `standard` quality.
         # Defaults to `auto`.
@@ -164,6 +189,9 @@ module OpenAI
             mask: OpenAI::Internal::FileInput,
             model: T.nilable(T.any(String, OpenAI::ImageModel::OrSymbol)),
             n: T.nilable(Integer),
+            output_compression: T.nilable(Integer),
+            output_format:
+              T.nilable(OpenAI::ImageEditParams::OutputFormat::OrSymbol),
             quality: T.nilable(OpenAI::ImageEditParams::Quality::OrSymbol),
             response_format:
               T.nilable(OpenAI::ImageEditParams::ResponseFormat::OrSymbol),
@@ -246,6 +274,29 @@ module OpenAI
         end
       end
 
+      # The format in which the generated images are returned. This parameter is only
+      # supported for `gpt-image-1`. Must be one of `png`, `jpeg`, or `webp`. The
+      # default value is `png`.
+      module OutputFormat
+        extend OpenAI::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, OpenAI::ImageEditParams::OutputFormat) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        PNG = T.let(:png, OpenAI::ImageEditParams::OutputFormat::TaggedSymbol)
+        JPEG = T.let(:jpeg, OpenAI::ImageEditParams::OutputFormat::TaggedSymbol)
+        WEBP = T.let(:webp, OpenAI::ImageEditParams::OutputFormat::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[OpenAI::ImageEditParams::OutputFormat::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+
       # The quality of the image that will be generated. `high`, `medium` and `low` are
       # only supported for `gpt-image-1`. `dall-e-2` only supports `standard` quality.
       # Defaults to `auto`.

data/rbi/openai/models/responses/response.rbi

@@ -42,13 +42,16 @@ module OpenAI
         end
         attr_writer :incomplete_details
 
-        # 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
         # swap out system (or developer) messages in new responses.
-        sig { returns(T.nilable(String)) }
+        sig do
+          returns(
+            T.nilable(OpenAI::Responses::Response::Instructions::Variants)
+          )
+        end
         attr_accessor :instructions
 
         # Set of 16 key-value pairs that can be attached to an object. This can be useful
@@ -143,6 +146,18 @@ module OpenAI
         sig { returns(T.nilable(String)) }
         attr_accessor :previous_response_id
 
+        # Reference to a prompt template and its variables.
+        # [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
+        sig { returns(T.nilable(OpenAI::Responses::ResponsePrompt)) }
+        attr_reader :prompt
+
+        sig do
+          params(
+            prompt: T.nilable(OpenAI::Responses::ResponsePrompt::OrHash)
+          ).void
+        end
+        attr_writer :prompt
+
         # **o-series models only**
         #
         # Configuration options for
@@ -236,7 +251,8 @@ module OpenAI
             error: T.nilable(OpenAI::Responses::ResponseError::OrHash),
             incomplete_details:
               T.nilable(OpenAI::Responses::Response::IncompleteDetails::OrHash),
-            instructions: T.nilable(String),
+            instructions:
+              T.nilable(OpenAI::Responses::Response::Instructions::Variants),
             metadata: T.nilable(T::Hash[Symbol, String]),
             model:
               T.any(
@@ -286,6 +302,7 @@ module OpenAI
             background: T.nilable(T::Boolean),
             max_output_tokens: T.nilable(Integer),
             previous_response_id: T.nilable(String),
+            prompt: T.nilable(OpenAI::Responses::ResponsePrompt::OrHash),
             reasoning: T.nilable(OpenAI::Reasoning::OrHash),
             service_tier:
               T.nilable(OpenAI::Responses::Response::ServiceTier::OrSymbol),
@@ -307,8 +324,7 @@ module OpenAI
           error:,
           # Details about why the response is incomplete.
           incomplete_details:,
-          # 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
@@ -378,6 +394,9 @@ module OpenAI
           # multi-turn conversations. Learn more about
           # [conversation state](https://platform.openai.com/docs/guides/conversation-state).
           previous_response_id: nil,
+          # Reference to a prompt template and its variables.
+          # [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
+          prompt: nil,
           # **o-series models only**
           #
           # Configuration options for
@@ -438,7 +457,8 @@ module OpenAI
               error: T.nilable(OpenAI::Responses::ResponseError),
               incomplete_details:
                 T.nilable(OpenAI::Responses::Response::IncompleteDetails),
-              instructions: T.nilable(String),
+              instructions:
+                T.nilable(OpenAI::Responses::Response::Instructions::Variants),
               metadata: T.nilable(T::Hash[Symbol, String]),
               model: OpenAI::ResponsesModel::Variants,
               object: Symbol,
@@ -451,6 +471,7 @@ module OpenAI
               background: T.nilable(T::Boolean),
               max_output_tokens: T.nilable(Integer),
               previous_response_id: T.nilable(String),
+              prompt: T.nilable(OpenAI::Responses::ResponsePrompt),
               reasoning: T.nilable(OpenAI::Reasoning),
               service_tier:
                 T.nilable(
@@ -557,6 +578,39 @@ module OpenAI
           end
         end
 
+        # 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
+        # swap out system (or developer) messages in new responses.
+        module Instructions
+          extend OpenAI::Internal::Type::Union
+
+          Variants =
+            T.type_alias do
+              T.any(
+                String,
+                T::Array[OpenAI::Responses::ResponseInputItem::Variants]
+              )
+            end
+
+          sig do
+            override.returns(
+              T::Array[OpenAI::Responses::Response::Instructions::Variants]
+            )
+          end
+          def self.variants
+          end
+
+          ResponseInputItemArray =
+            T.let(
+              OpenAI::Internal::Type::ArrayOf[
+                union: OpenAI::Responses::ResponseInputItem
+              ],
+              OpenAI::Internal::Type::Converter
+            )
+        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.
@@ -616,6 +670,11 @@ module OpenAI
             )
           FLEX =
             T.let(:flex, OpenAI::Responses::Response::ServiceTier::TaggedSymbol)
+          SCALE =
+            T.let(
+              :scale,
+              OpenAI::Responses::Response::ServiceTier::TaggedSymbol
+            )
 
           sig do
             override.returns(